ootk 6.0.0-rc.4 → 6.0.0

package/dist/scheduling/ScheduledContact.d.ts

@@ -1,155 +0,0 @@
-/**
- * @author Theodore Kruczek
- * @license AGPL-3.0-or-later
- * @copyright (c) 2025 Kruczek Labs LLC
- *
- * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
- * terms of the GNU Affero General Public License as published by the Free Software
- * Foundation, either version 3 of the License, or (at your option) any later version.
- *
- * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
- * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
- * See the GNU Affero General Public License for more details.
- *
- * You should have received a copy of the GNU Affero General Public License along with
- * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
- */
-import type { Degrees, Kilometers } from '../types/types';
-import type { AccessWindow } from '../objects/AccessWindow';
-import type { GroundObject } from '../objects/GroundObject';
-import type { GroundStation } from '../objects/GroundStation';
-import type { Satellite } from '../objects/Satellite';
-import type { SpaceObject } from '../objects/SpaceObject';
-/**
- * Represents a time window with start and end dates.
- * Used for coverage gap analysis.
- */
-export interface TimeWindow {
-    /** Start of the time window */
-    start: Date;
-    /** End of the time window */
-    end: Date;
-    /** Duration in milliseconds */
-    duration: number;
-}
-/**
- * Parameters for constructing a ScheduledContact.
- */
-export interface ScheduledContactParams {
-    /** The underlying access window from AccessCalculator */
-    accessWindow: AccessWindow;
-    /** Priority assigned to this contact (higher = more important) */
-    priority: number;
-    /** Scheduled start time (may differ from access window start for partial contacts) */
-    scheduledStart?: Date;
-    /** Scheduled end time (may differ from access window end for partial contacts) */
-    scheduledEnd?: Date;
-    /** Optional metadata for user-defined properties */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Represents a scheduled contact between a ground station and satellite.
- *
- * ScheduledContact wraps an AccessWindow with scheduling-specific information
- * such as priority and potentially trimmed start/end times for partial contacts
- * or handovers.
- *
- * @example
- * ```typescript
- * const contact = new ScheduledContact({
- *   accessWindow: window,
- *   priority: 10,
- *   scheduledStart: window.start,
- *   scheduledEnd: window.end,
- * });
- *
- * console.log(contact.toString());
- * // [ScheduledContact]
- * //   Station: Goldstone
- * //   Satellite: ISS
- * //   Time: 10:00:00 - 10:15:00
- * //   Max Elevation: 45.2°
- * //   Priority: 10
- * ```
- */
-export declare class ScheduledContact {
-    /** The underlying access window */
-    readonly accessWindow: AccessWindow;
-    /** Priority assigned to this contact (higher = more important) */
-    readonly priority: number;
-    /** Scheduled start time (may be trimmed from access window) */
-    readonly scheduledStart: Date;
-    /** Scheduled end time (may be trimmed from access window) */
-    readonly scheduledEnd: Date;
-    /** Duration of the scheduled contact in milliseconds */
-    readonly scheduledDuration: number;
-    /** Optional metadata for user-defined properties */
-    readonly metadata?: Record<string, unknown>;
-    constructor(params: ScheduledContactParams);
-    /**
-     * Access window start time.
-     */
-    get start(): Date;
-    /**
-     * Access window end time.
-     */
-    get end(): Date;
-    /**
-     * Access window duration in milliseconds.
-     */
-    get duration(): number;
-    /**
-     * Maximum elevation achieved during the pass.
-     */
-    get maxElevation(): Degrees;
-    /**
-     * Time of maximum elevation.
-     */
-    get maxElevationTime(): Date;
-    /**
-     * Range at maximum elevation.
-     */
-    get rangeAtMaxEl(): Kilometers;
-    /**
-     * The observing ground object.
-     */
-    get observer(): GroundObject;
-    /**
-     * The observed space object.
-     */
-    get target(): SpaceObject;
-    /**
-     * The ground station (convenience getter assuming observer is GroundStation).
-     */
-    get station(): GroundStation;
-    /**
-     * The satellite (convenience getter assuming target is Satellite).
-     */
-    get satellite(): Satellite;
-    /**
-     * Checks if this contact's scheduled time overlaps with another contact.
-     * @param other - The other contact to check
-     * @returns True if the scheduled times overlap
-     */
-    overlaps(other: ScheduledContact): boolean;
-    /**
-     * Checks if this contact conflicts with another contact at the same station.
-     * Two contacts conflict if they use the same station and overlap in time.
-     * @param other - The other contact to check
-     * @param handoverMs - Optional handover time buffer in milliseconds
-     * @returns True if both contacts use the same station and overlap in time
-     */
-    conflictsWith(other: ScheduledContact, handoverMs?: number): boolean;
-    /**
-     * Creates a copy of this contact with adjusted scheduled times.
-     * @param newStart - New scheduled start time
-     * @param newEnd - New scheduled end time
-     * @returns A new ScheduledContact with the updated times
-     */
-    withTimes(newStart: Date, newEnd: Date): ScheduledContact;
-    /**
-     * Formats a Date as HH:MM:SS.
-     */
-    private static formatTime_;
-    toString(): string;
-}

package/dist/scheduling/ScheduledContact.js

@@ -1,189 +0,0 @@
-/**
- * @author Theodore Kruczek
- * @license AGPL-3.0-or-later
- * @copyright (c) 2025 Kruczek Labs LLC
- *
- * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
- * terms of the GNU Affero General Public License as published by the Free Software
- * Foundation, either version 3 of the License, or (at your option) any later version.
- *
- * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
- * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
- * See the GNU Affero General Public License for more details.
- *
- * You should have received a copy of the GNU Affero General Public License along with
- * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
- */
-/**
- * Represents a scheduled contact between a ground station and satellite.
- *
- * ScheduledContact wraps an AccessWindow with scheduling-specific information
- * such as priority and potentially trimmed start/end times for partial contacts
- * or handovers.
- *
- * @example
- * ```typescript
- * const contact = new ScheduledContact({
- *   accessWindow: window,
- *   priority: 10,
- *   scheduledStart: window.start,
- *   scheduledEnd: window.end,
- * });
- *
- * console.log(contact.toString());
- * // [ScheduledContact]
- * //   Station: Goldstone
- * //   Satellite: ISS
- * //   Time: 10:00:00 - 10:15:00
- * //   Max Elevation: 45.2°
- * //   Priority: 10
- * ```
- */
-export class ScheduledContact {
-    /** The underlying access window */
-    accessWindow;
-    /** Priority assigned to this contact (higher = more important) */
-    priority;
-    /** Scheduled start time (may be trimmed from access window) */
-    scheduledStart;
-    /** Scheduled end time (may be trimmed from access window) */
-    scheduledEnd;
-    /** Duration of the scheduled contact in milliseconds */
-    scheduledDuration;
-    /** Optional metadata for user-defined properties */
-    metadata;
-    constructor(params) {
-        this.accessWindow = params.accessWindow;
-        this.priority = params.priority;
-        this.scheduledStart = params.scheduledStart ?? params.accessWindow.start;
-        this.scheduledEnd = params.scheduledEnd ?? params.accessWindow.end;
-        this.scheduledDuration = this.scheduledEnd.getTime() - this.scheduledStart.getTime();
-        this.metadata = params.metadata;
-    }
-    /**
-     * Access window start time.
-     */
-    get start() {
-        return this.accessWindow.start;
-    }
-    /**
-     * Access window end time.
-     */
-    get end() {
-        return this.accessWindow.end;
-    }
-    /**
-     * Access window duration in milliseconds.
-     */
-    get duration() {
-        return this.accessWindow.duration;
-    }
-    /**
-     * Maximum elevation achieved during the pass.
-     */
-    get maxElevation() {
-        return this.accessWindow.maxElevation;
-    }
-    /**
-     * Time of maximum elevation.
-     */
-    get maxElevationTime() {
-        return this.accessWindow.maxElevationTime;
-    }
-    /**
-     * Range at maximum elevation.
-     */
-    get rangeAtMaxEl() {
-        return this.accessWindow.rangeAtMaxEl;
-    }
-    /**
-     * The observing ground object.
-     */
-    get observer() {
-        return this.accessWindow.observer;
-    }
-    /**
-     * The observed space object.
-     */
-    get target() {
-        return this.accessWindow.target;
-    }
-    /**
-     * The ground station (convenience getter assuming observer is GroundStation).
-     */
-    get station() {
-        return this.accessWindow.observer;
-    }
-    /**
-     * The satellite (convenience getter assuming target is Satellite).
-     */
-    get satellite() {
-        return this.accessWindow.target;
-    }
-    /**
-     * Checks if this contact's scheduled time overlaps with another contact.
-     * @param other - The other contact to check
-     * @returns True if the scheduled times overlap
-     */
-    overlaps(other) {
-        return !(this.scheduledEnd.getTime() <= other.scheduledStart.getTime() ||
-            this.scheduledStart.getTime() >= other.scheduledEnd.getTime());
-    }
-    /**
-     * Checks if this contact conflicts with another contact at the same station.
-     * Two contacts conflict if they use the same station and overlap in time.
-     * @param other - The other contact to check
-     * @param handoverMs - Optional handover time buffer in milliseconds
-     * @returns True if both contacts use the same station and overlap in time
-     */
-    conflictsWith(other, handoverMs = 0) {
-        // Different stations = no conflict
-        if (this.station.id !== other.station.id) {
-            return false;
-        }
-        // Check time overlap with handover buffer
-        const thisEnd = this.scheduledEnd.getTime() + handoverMs;
-        const otherEnd = other.scheduledEnd.getTime() + handoverMs;
-        return !(thisEnd <= other.scheduledStart.getTime() ||
-            this.scheduledStart.getTime() >= otherEnd);
-    }
-    /**
-     * Creates a copy of this contact with adjusted scheduled times.
-     * @param newStart - New scheduled start time
-     * @param newEnd - New scheduled end time
-     * @returns A new ScheduledContact with the updated times
-     */
-    withTimes(newStart, newEnd) {
-        return new ScheduledContact({
-            accessWindow: this.accessWindow,
-            priority: this.priority,
-            scheduledStart: newStart,
-            scheduledEnd: newEnd,
-            metadata: this.metadata,
-        });
-    }
-    /**
-     * Formats a Date as HH:MM:SS.
-     */
-    static formatTime_(date) {
-        const h = date.getUTCHours().toString().padStart(2, '0');
-        const m = date.getUTCMinutes().toString().padStart(2, '0');
-        const s = date.getUTCSeconds().toString().padStart(2, '0');
-        return `${h}:${m}:${s}`;
-    }
-    toString() {
-        const startTime = ScheduledContact.formatTime_(this.scheduledStart);
-        const endTime = ScheduledContact.formatTime_(this.scheduledEnd);
-        const stationName = this.station.name || this.station.id;
-        const satName = this.satellite.name || String(this.satellite.id);
-        return [
-            '[ScheduledContact]',
-            `  Station: ${stationName}`,
-            `  Satellite: ${satName}`,
-            `  Time: ${startTime} - ${endTime}`,
-            `  Max Elevation: ${this.maxElevation.toFixed(1)}°`,
-            `  Priority: ${this.priority}`,
-        ].join('\n');
-    }
-}
-//# sourceMappingURL=ScheduledContact.js.map

package/dist/scheduling/ScheduledContact.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ScheduledContact.js","sourceRoot":"","sources":["../../src/scheduling/ScheduledContact.ts"],"names":[],"mappings":"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"}

package/dist/scheduling/index.d.ts

@@ -1,5 +0,0 @@
-export { ContactScheduler } from './ContactScheduler';
-export { ContactSelectionStrategy } from './ContactScheduler';
-export type { CoverageStatistics, SatelliteCoverageStats, ScheduleOptions, StationCoverageStats, } from './ContactScheduler';
-export { ScheduledContact } from './ScheduledContact';
-export type { ScheduledContactParams, TimeWindow } from './ScheduledContact';

package/dist/scheduling/index.js

@@ -1,4 +0,0 @@
-export { ContactScheduler } from './ContactScheduler';
-export { ContactSelectionStrategy } from './ContactScheduler';
-export { ScheduledContact } from './ScheduledContact';
-//# sourceMappingURL=index.js.map

package/dist/scheduling/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scheduling/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAO9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/sensor/FieldOfView.d.ts

@@ -1,250 +0,0 @@
-/**
- * @author Theodore Kruczek
- * @license AGPL-3.0-or-later
- * @copyright (c) 2025 Kruczek Labs LLC
- *
- * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
- * terms of the GNU Affero General Public License as published by the Free Software
- * Foundation, either version 3 of the License, or (at your option) any later version.
- *
- * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
- * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
- * See the GNU Affero General Public License for more details.
- *
- * You should have received a copy of the GNU Affero General Public License along with
- * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
- */
-import { FovFrame, FovShape } from '../enums';
-import { Vector3D } from '../operations/Vector3D';
-import { Degrees, Kilometers, Radians, RaeVec3 } from '../types/types';
-/**
- * Azimuth-dependent elevation mask for terrain/obstructions.
- * Used to define regions where the minimum elevation is higher than the global minimum
- * due to buildings, mountains, or other obstructions.
- */
-export interface ElevationMask {
-    /** Start of azimuth range in degrees (inclusive) */
-    startAz: Degrees;
-    /** End of azimuth range in degrees (inclusive), handles wraparound */
-    stopAz: Degrees;
-    /** Minimum elevation in degrees for this azimuth range */
-    minEl: Degrees;
-}
-/**
- * Parameters for constructing a FieldOfView.
- */
-export interface FieldOfViewParams {
-    /** Boresight azimuth in degrees (default: 0° = North) */
-    boresightAz?: Degrees;
-    /** Boresight elevation in degrees (default: 90° = zenith) */
-    boresightEl?: Degrees;
-    /** Half-angle of FOV cone in degrees (major axis for elliptical) */
-    halfAngle: Degrees;
-    /** Minor half-angle for elliptical cone (defaults to halfAngle for circular) */
-    minorHalfAngle?: Degrees;
-    /** Roll angle for elliptical cone orientation in degrees (default: 0°) */
-    rollAngle?: Degrees;
-    /** Minimum range in kilometers */
-    minRange: Kilometers;
-    /** Maximum range in kilometers */
-    maxRange: Kilometers;
-    /** Global minimum elevation in degrees (default: 0°) */
-    minElevation?: Degrees;
-    /** Azimuth-specific elevation masks for terrain/buildings */
-    elevationMasks?: ElevationMask[];
-    /** FOV shape type (default: ELLIPTICAL_CONE) */
-    shape?: FovShape;
-    /** Reference frame for boresight (default: TOPOCENTRIC) */
-    frame?: FovFrame;
-}
-/**
- * Orthonormal basis representing the boresight frame.
- * Used for transforming target directions into boresight-relative coordinates.
- */
-export interface BoresightFrame {
-    /** Boresight direction (unit vector) */
-    b: Vector3D;
-    /** Major axis direction (unit vector, perpendicular to boresight) */
-    u: Vector3D;
-    /** Minor axis direction (unit vector, perpendicular to both b and u) */
-    v: Vector3D;
-}
-/**
- * Constructs a boresight frame from azimuth, elevation, and roll angles.
- *
- * The frame is constructed using the ENU (East-North-Up) convention:
- * - Azimuth 0° is North, 90° is East
- * - Elevation 0° is horizontal, 90° is zenith
- * - Roll 0° means major axis aligns with the projection of "up" onto the
- *   plane perpendicular to boresight
- *
- * @param az - Boresight azimuth in radians
- * @param el - Boresight elevation in radians
- * @param roll - Roll angle in radians
- * @returns Orthonormal boresight frame
- */
-export declare function boresightFrameFromAzElRoll(az: Radians, el: Radians, roll: Radians): BoresightFrame;
-/**
- * Boresight-centric field of view using elliptical cone geometry.
- *
- * Defines a sensor's FOV as an elliptical cone around a boresight direction,
- * with optional azimuth-dependent elevation masking for terrain/obstructions.
- *
- * @example
- * ```typescript
- * // Circular cone pointing at zenith
- * const fov = new FieldOfView({
- *   halfAngle: 45 as Degrees,
- *   minRange: 100 as Kilometers,
- *   maxRange: 50000 as Kilometers,
- * });
- *
- * // Elliptical fan-shaped FOV (phased array radar)
- * const fanFov = new FieldOfView({
- *   boresightEl: 90 as Degrees,
- *   halfAngle: 90 as Degrees,       // 90° in major direction
- *   minorHalfAngle: 2 as Degrees,   // 2° in minor direction
- *   rollAngle: 0 as Degrees,        // Major axis aligned N-S
- *   minRange: 100 as Kilometers,
- *   maxRange: 50000 as Kilometers,
- * });
- *
- * // Check if target is visible
- * const rae = { rng: 1000, az: 45, el: 30 };
- * if (fov.contains(rae)) {
- *   console.log('Target is in FOV');
- * }
- * ```
- */
-export declare class FieldOfView {
-    /** Boresight azimuth in degrees */
-    readonly boresightAz: Degrees;
-    /** Boresight elevation in degrees */
-    readonly boresightEl: Degrees;
-    /** Major half-angle in degrees */
-    readonly halfAngle: Degrees;
-    /** Minor half-angle in degrees */
-    readonly minorHalfAngle: Degrees;
-    /** Roll angle in degrees */
-    readonly rollAngle: Degrees;
-    /** Minimum range in kilometers */
-    readonly minRange: Kilometers;
-    /** Maximum range in kilometers */
-    readonly maxRange: Kilometers;
-    /** Global minimum elevation in degrees */
-    readonly minElevation: Degrees;
-    /** Azimuth-specific elevation masks */
-    readonly elevationMasks: ElevationMask[];
-    /** FOV shape type */
-    readonly shape: FovShape;
-    /** Reference frame for boresight */
-    readonly frame: FovFrame;
-    /** Cached boresight frame for performance */
-    private readonly boresightFrame_;
-    /** Cached half angles in radians */
-    private readonly halfAngleRad_;
-    private readonly minorHalfAngleRad_;
-    constructor(params: FieldOfViewParams);
-    /**
-     * Creates a hemisphere FOV (all-sky coverage above minimum elevation).
-     * @param minRange - Minimum range in kilometers
-     * @param maxRange - Maximum range in kilometers
-     * @param minEl - Minimum elevation (default: 0°)
-     * @returns FieldOfView covering the hemisphere
-     */
-    static hemisphere(minRange: Kilometers, maxRange: Kilometers, minEl?: Degrees): FieldOfView;
-    /**
-     * Creates a circular cone FOV.
-     * @param boresightAz - Boresight azimuth in degrees
-     * @param boresightEl - Boresight elevation in degrees
-     * @param halfAngle - Cone half-angle in degrees
-     * @param minRange - Minimum range in kilometers
-     * @param maxRange - Maximum range in kilometers
-     * @returns FieldOfView with circular cone
-     */
-    static circularCone(boresightAz: Degrees, boresightEl: Degrees, halfAngle: Degrees, minRange: Kilometers, maxRange: Kilometers): FieldOfView;
-    /**
-     * Checks if the given RAE coordinates are within this field of view.
-     *
-     * Performs the following checks in order:
-     * 1. Range bounds
-     * 2. Elevation masking (global and azimuth-specific)
-     * 3. Elliptical cone containment
-     *
-     * @param rae - The RAE coordinates to check
-     * @returns True if the coordinates are within the FOV
-     */
-    contains(rae: RaeVec3<Kilometers, Degrees>): boolean;
-    /**
-     * Checks if a direction vector is within the FOV angular bounds.
-     * For body-frame sensors receiving body-frame directions.
-     *
-     * @param direction - Direction vector to target (will be normalized)
-     * @param range - Range to target in kilometers
-     * @returns True if within FOV
-     */
-    containsDirection(direction: Vector3D, range: Kilometers): boolean;
-    /**
-     * Gets the effective minimum elevation at a given azimuth.
-     * Considers all applicable elevation masks and returns the most restrictive.
-     *
-     * @param az - Azimuth in degrees
-     * @returns Effective minimum elevation in degrees
-     */
-    getMinElevation(az: Degrees): Degrees;
-    /**
-     * Returns the boresight as a unit vector in the topocentric (ENU) frame.
-     */
-    get boresightVector(): Vector3D;
-    /**
-     * Calculates the angular offset from boresight to a target.
-     * @param az - Target azimuth in degrees
-     * @param el - Target elevation in degrees
-     * @returns Angular offset in degrees
-     */
-    angularOffset(az: Degrees, el: Degrees): Degrees;
-    /**
-     * Returns true if the FOV is circular (major = minor half-angle).
-     */
-    get isCircular(): boolean;
-    /**
-     * Gets the full angular coverage (2 * halfAngle) in degrees.
-     * For scanning radars, this represents the sweep width.
-     */
-    get angularCoverage(): Degrees;
-    /**
-     * Checks if this FOV is configured for deep space observation.
-     * Deep space is defined as max range > 6000 km.
-     */
-    isDeepSpace(): boolean;
-    /**
-     * Checks if this FOV is configured for near-Earth observation.
-     * Near Earth is defined as max range <= 6000 km.
-     */
-    isNearEarth(): boolean;
-    /**
-     * Creates a serializable representation of this FOV.
-     */
-    serialize(): FieldOfViewParams;
-    /**
-     * Returns a string representation of this FOV.
-     */
-    toString(): string;
-    /**
-     * Checks if an azimuth falls within an elevation mask's range.
-     * Handles wraparound (e.g., 350° to 10°).
-     */
-    private isAzimuthInMaskRange;
-    /**
-     * Core containment check for cone geometry using az/el.
-     */
-    private isWithinCone;
-    /**
-     * Core containment check for cone geometry using direction vector.
-     */
-    private isDirectionWithinCone;
-    /**
-     * Validates FOV parameters.
-     */
-    private validate;
-}