ootk 3.0.0 → 4.0.0-0

package/lib/maneuver/Waypoint.js

@@ -0,0 +1,152 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ *
+ * @license AGPL-3.0-or-later
+ * @Copyright (c) 2020-2024 Theodore Kruczek
+ *
+ * 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 { RIC, Vector3D } from 'ootk-core';
+import { Thrust } from '../force/Thrust';
+import { ForceModel } from './../force/ForceModel';
+import { DownhillSimplex } from './../optimize/DownhillSimplex';
+import { LambertIOD } from './../orbit_determination/LambertIOD';
+import { RungeKutta89Propagator } from './../propagator/RungeKutta89Propagator';
+// / Relative waypoint targeting.
+export class Waypoint {
+    // / Create a new [Waypoint] object.
+    constructor(epoch, relativePosition) {
+        this.epoch = epoch;
+        this.relativePosition = relativePosition;
+    }
+    /**
+     * Return the perturbed error in a [maneuver] when compared against the
+     * target [waypoint] given an initial [state], [forceModel],
+     * [target] interpolator, and speculative relative maneuver
+     * [components] _(m/s)_.
+     */
+    static _error(waypoint, maneuver, state, forceModel, target, components) {
+        const testManeuver = new Thrust(maneuver.center, components[0], components[1], components[2], maneuver.durationRate);
+        const propagator = new RungeKutta89Propagator(state, forceModel);
+        const maneuverSteps = propagator.maneuver(testManeuver);
+        const postManeuver = maneuverSteps[maneuverSteps.length - 1];
+        const interceptor = new RungeKutta89Propagator(postManeuver, forceModel).propagate(waypoint.epoch);
+        const targetState = target.interpolate(waypoint.epoch);
+        if (targetState === null) {
+            throw new Error('Error calculation failed; epoch is outside the target interpolator ephemeris window.');
+        }
+        const expected = waypoint.relativePosition;
+        const actual = RIC.fromJ2000(interceptor, targetState);
+        return actual.position.distance(expected);
+    }
+    /**
+     * Generate a score function for refining perturbed [waypoint] maneuvers.
+     *
+     * The score function takes an array of speculative radial, intrack, and
+     * crosstrack components _(m/s)_ and returns the propagated error from the
+     * desired waypoint target.
+     */
+    static _refineManeuverScore(waypoint, maneuver, state, forceModel, target) {
+        return (components) => Waypoint._error(waypoint, maneuver, state, forceModel, target, components);
+    }
+    /**
+     * Convert an array of [waypoints] into a maneuver sequence given an
+     * [interceptor] state, [pivot] epoch for the first burn to arrive at the
+     * first waypoint, and [target] ephemeris interpolator.
+     *
+     * Optional arguments are as follows:
+     *  - `preManeuvers`: maneuvers to execute before the pivot burn
+     * - `postManeuvers`: maneuvers to execute after the last pivot burn
+     * - `durationRate`: thruster duration rate _(s/m/s)_
+     * - `forceModel`: interceptor force model, defaults to two-body
+     * - `refine`: refine maneuvers to account for perturbations if `true`
+     * - `maxIter`: maximum refinement iterations per maneuver
+     * - `printIter`: print debug information on each refinement iteration
+     */
+    static toManeuvers(interceptor, pivot, waypoints, target, preManeuvers, postManeuvers, { durationRate = 0.0, forceModel, refine = false, maxIter = 500, printIter = false, } = {}) {
+        const preMnv = preManeuvers ?? [];
+        const postMnv = postManeuvers ?? [];
+        let state = interceptor;
+        if (preMnv.length > 0) {
+            for (const maneuver of preMnv) {
+                const mvrStep = new RungeKutta89Propagator(state, forceModel).maneuver(maneuver);
+                state = mvrStep[mvrStep.length - 1];
+            }
+        }
+        state = new RungeKutta89Propagator(state, forceModel).propagate(pivot);
+        const pivotState = state;
+        let waypointManeuvers = [];
+        for (const wp of waypoints) {
+            const targetWp = new RIC(wp.relativePosition, Vector3D.origin);
+            const targetState = target.interpolate(wp.epoch);
+            if (targetState === null) {
+                throw new Error('Waypoint outside target interpolator window.');
+            }
+            const wpState = targetWp.toJ2000(targetState);
+            const tof = wp.epoch.difference(state.epoch);
+            const revs = Math.floor(tof / state.period());
+            const shortPath = LambertIOD.useShortPath(state, targetState);
+            const lambert = new LambertIOD();
+            const components = lambert.estimate(state.position, wpState.position, state.epoch, wp.epoch, {
+                posigrade: shortPath,
+                nRev: revs,
+            });
+            if (components === null) {
+                throw new Error('Lambert solve result is null.');
+            }
+            const componentsRel = RIC.fromJ2000(components, state).velocity.scale(1e3);
+            const maneuver = new Thrust(state.epoch, componentsRel.x, componentsRel.y, componentsRel.z, durationRate);
+            const tempProp = new RungeKutta89Propagator(state, forceModel);
+            tempProp.maneuver(maneuver);
+            state = tempProp.propagate(wp.epoch);
+            waypointManeuvers.push(maneuver);
+        }
+        if (refine) {
+            forceModel ??= new ForceModel().setGravity();
+            waypointManeuvers = this._refineManeuvers(waypoints, waypointManeuvers, pivotState, forceModel, target, {
+                maxIter,
+                printIter,
+            });
+        }
+        const output = [];
+        output.push(...preMnv);
+        output.push(...waypointManeuvers);
+        output.push(...postMnv);
+        return output;
+    }
+    static _refineManeuvers(waypoints, maneuvers, interceptor, forceModel, target, { maxIter = 500, printIter = false, } = {}) {
+        let state = interceptor;
+        const output = [];
+        for (let i = 0; i < maneuvers.length; i++) {
+            const maneuver = maneuvers[i];
+            const waypoint = waypoints[i];
+            const guess = maneuver.deltaV.scale(1e3).toArray();
+            const simplex = DownhillSimplex.generateSimplex(guess, 1e-1);
+            const scoreFn = this._refineManeuverScore(waypoint, maneuver, state, forceModel, target);
+            const results = DownhillSimplex.solveSimplex(scoreFn, simplex, {
+                maxIter,
+                xTolerance: 1e-6,
+                fTolerance: 1e-6,
+                printIter,
+            });
+            const tR = results[0];
+            const tI = results[1];
+            const tC = results[2];
+            const newManeuver = new Thrust(maneuver.center, tR, tI, tC, maneuver.durationRate);
+            output.push(newManeuver);
+            const mvrStep = new RungeKutta89Propagator(state, forceModel).maneuver(newManeuver);
+            state = mvrStep[mvrStep.length - 1];
+        }
+        return output;
+    }
+}
+//# sourceMappingURL=Waypoint.js.map

package/lib/maneuver/Waypoint.js.map

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

package/lib/objects/DetailedSatellite.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ *
+ * @license AGPL-3.0-or-later
+ * @Copyright (c) 2020-2024 Theodore Kruczek
+ *
+ * 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 { EciVec3, Kilometers, LaunchDetails, OperationsDetails, OptionsParams, Satellite, SatelliteParams, SpaceCraftDetails } from 'ootk-core';
+import { DetailedSatelliteParams } from '../types/types';
+/**
+ * Represents a detailed satellite object with launch, spacecraft, and operations details.
+ */
+export declare class DetailedSatellite extends Satellite {
+    /** A global index - this is NOT the sccNum */
+    configuration: string;
+    country: string;
+    dryMass: string;
+    equipment: string;
+    launchDate: string;
+    launchMass: string;
+    launchSite: string;
+    launchVehicle: string;
+    lifetime: string | number;
+    maneuver: string;
+    manufacturer: string;
+    mission: string;
+    bus: string;
+    motor: string;
+    owner: string;
+    payload: string;
+    power: string;
+    purpose: string;
+    length: string;
+    diameter: string;
+    shape: string;
+    span: string;
+    user: string;
+    source: string;
+    vmag: number;
+    rcs: number;
+    totalVelocity: number;
+    velocity: EciVec3<Kilometers>;
+    semiMajorAxis: number;
+    semiMinorAxis: number;
+    altId: string;
+    altName: string;
+    constructor(info: DetailedSatelliteParams & SatelliteParams & LaunchDetails & OperationsDetails & SpaceCraftDetails, options?: OptionsParams);
+    /**
+     * Returns the launch details of the satellite.
+     * @returns An object containing the launch date, launch mass, launch site, and launch vehicle of the satellite.
+     */
+    getLaunchDetails(): LaunchDetails;
+    /**
+     * Returns an object containing the details of the operations.
+     * @returns An object containing the user, mission, owner, and country details.
+     */
+    getOperationsDetails(): OperationsDetails;
+    /**
+     * Returns the space craft details.
+     * @returns {SpaceCraftDetails} The space craft details.
+     */
+    getSpaceCraftDetails(): SpaceCraftDetails;
+    /**
+     * Propagates the satellite position to the given date using the SGP4 model.
+     *
+     * This method changes the position and time properties of the satellite object.
+     */
+    propagateTo(date: Date): this;
+    /**
+     * Sets the launch details of the satellite.
+     * @param details - The launch details to set.
+     */
+    setLaunchDetails(details: LaunchDetails): void;
+    /**
+     * Sets the operations details for the satellite.
+     * @param details - The operations details to set.
+     */
+    setOperationsDetails(details: OperationsDetails): void;
+    /**
+     * Sets the details of a spacecraft.
+     * @param details - The details of the spacecraft to set.
+     */
+    setSpaceCraftDetails(details: SpaceCraftDetails): void;
+}

package/lib/objects/DetailedSatellite.js

@@ -0,0 +1,140 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ *
+ * @license AGPL-3.0-or-later
+ * @Copyright (c) 2020-2024 Theodore Kruczek
+ *
+ * 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 { Satellite, Vector3D, } from 'ootk-core';
+/**
+ * Represents a detailed satellite object with launch, spacecraft, and operations details.
+ */
+export class DetailedSatellite extends Satellite {
+    constructor(info, options) {
+        super(info, options);
+        this.active ??= true;
+        this.setLaunchDetails(info);
+        this.setSpaceCraftDetails(info);
+        this.setOperationsDetails(info);
+        Object.keys(info).forEach((key) => {
+            this[key] = info[key];
+        });
+    }
+    /**
+     * Returns the launch details of the satellite.
+     * @returns An object containing the launch date, launch mass, launch site, and launch vehicle of the satellite.
+     */
+    getLaunchDetails() {
+        return {
+            launchDate: this.launchDate,
+            launchMass: this.launchMass,
+            launchSite: this.launchSite,
+            launchVehicle: this.launchVehicle,
+        };
+    }
+    /**
+     * Returns an object containing the details of the operations.
+     * @returns An object containing the user, mission, owner, and country details.
+     */
+    getOperationsDetails() {
+        return {
+            user: this.user,
+            mission: this.mission,
+            owner: this.owner,
+            country: this.country,
+        };
+    }
+    /**
+     * Returns the space craft details.
+     * @returns {SpaceCraftDetails} The space craft details.
+     */
+    getSpaceCraftDetails() {
+        return {
+            lifetime: this.lifetime,
+            maneuver: this.maneuver,
+            manufacturer: this.manufacturer,
+            motor: this.motor,
+            power: this.power,
+            payload: this.payload,
+            purpose: this.purpose,
+            shape: this.shape,
+            span: this.span,
+            configuration: this.configuration,
+            equipment: this.equipment,
+            dryMass: this.dryMass,
+        };
+    }
+    /**
+     * Propagates the satellite position to the given date using the SGP4 model.
+     *
+     * This method changes the position and time properties of the satellite object.
+     */
+    propagateTo(date) {
+        const pv = this.getEci(date);
+        this.position = pv.position;
+        this.velocity = pv.velocity;
+        this.totalVelocity = new Vector3D(pv.velocity.x, pv.velocity.y, pv.velocity.z).magnitude();
+        this.time = date;
+        return this;
+    }
+    /**
+     * Sets the launch details of the satellite.
+     * @param details - The launch details to set.
+     */
+    setLaunchDetails(details) {
+        const keys = ['launchDate', 'launchMass', 'launchSite', 'launchVehicle'];
+        keys.forEach((key) => {
+            if (details[key]) {
+                this[key] = details[key];
+            }
+        });
+    }
+    /**
+     * Sets the operations details for the satellite.
+     * @param details - The operations details to set.
+     */
+    setOperationsDetails(details) {
+        const keys = ['user', 'mission', 'owner', 'country'];
+        keys.forEach((key) => {
+            if (details[key]) {
+                this[key] = details[key];
+            }
+        });
+    }
+    /**
+     * Sets the details of a spacecraft.
+     * @param details - The details of the spacecraft to set.
+     */
+    setSpaceCraftDetails(details) {
+        const keys = [
+            'lifetime',
+            'maneuver',
+            'manufacturer',
+            'motor',
+            'power',
+            'payload',
+            'purpose',
+            'shape',
+            'span',
+            'configuration',
+            'equipment',
+            'dryMass',
+        ];
+        keys.forEach((key) => {
+            if (details[key]) {
+                this[key] = details[key];
+            }
+        });
+    }
+}
+//# sourceMappingURL=DetailedSatellite.js.map

package/lib/objects/DetailedSatellite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetailedSatellite.js","sourceRoot":"","sources":["../../src/objects/DetailedSatellite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAML,SAAS,EAGT,QAAQ,GACT,MAAM,WAAW,CAAC;AAGnB;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAmC9C,YACE,IAAuG,EACvG,OAAuB;QAEvB,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAErB,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;QACrB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAEhC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAChC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,gBAAgB;QACd,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,oBAAoB;QAClB,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,oBAAoB;QAClB,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,IAAU;QACpB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE7B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,EAAgB,CAAC;QACzG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,OAAsB;QACrC,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;QAEzE,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE;gBAChB,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;aAC1B;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,oBAAoB,CAAC,OAA0B;QAC7C,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAErD,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE;gBAChB,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;aAC1B;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,oBAAoB,CAAC,OAA0B;QAC7C,MAAM,IAAI,GAAG;YACX,UAAU;YACV,UAAU;YACV,cAAc;YACd,OAAO;YACP,OAAO;YACP,SAAS;YACT,SAAS;YACT,OAAO;YACP,MAAM;YACN,eAAe;YACf,WAAW;YACX,SAAS;SACV,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE;gBAChB,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;aAC1B;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/lib/objects/DetailedSensor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ *
+ * @license AGPL-3.0-or-later
+ * @Copyright (c) 2020-2024 Theodore Kruczek
+ *
+ * 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 { BaseObjectParams, Degrees, Milliseconds, Radians, Sensor, SensorParams } from 'ootk-core';
+import { DetailedSensorParams, ZoomValue } from '../types/types';
+export declare class DetailedSensor extends Sensor {
+    country?: string;
+    latRad: Radians;
+    lonRad: Radians;
+    shortName?: string;
+    beamwidth?: Degrees;
+    changeObjectInterval?: Milliseconds;
+    linkAehf?: boolean;
+    linkGalileo?: boolean;
+    linkIridium?: boolean;
+    linkStarlink?: boolean;
+    linkWgs?: boolean;
+    static?: boolean;
+    sensorId?: number;
+    url?: string;
+    volume?: boolean;
+    zoom: ZoomValue;
+    band?: string;
+    objName?: string;
+    uiName?: string;
+    system?: string;
+    operator?: string;
+    constructor(info: DetailedSensorParams & SensorParams & BaseObjectParams);
+}

package/lib/objects/DetailedSensor.js

@@ -0,0 +1,45 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ *
+ * @license AGPL-3.0-or-later
+ * @Copyright (c) 2020-2024 Theodore Kruczek
+ *
+ * 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 { Sensor } from 'ootk-core';
+export class DetailedSensor extends Sensor {
+    constructor(info) {
+        super(info);
+        this.country = info.country;
+        this.latRad = (info.lat * (Math.PI / 180));
+        this.lonRad = (info.lon * (Math.PI / 180));
+        this.shortName = info.shortName;
+        this.beamwidth = info.beamwidth;
+        this.changeObjectInterval = info.changeObjectInterval;
+        this.linkAehf = info.linkAehf;
+        this.linkGalileo = info.linkGalileo;
+        this.linkIridium = info.linkIridium;
+        this.linkStarlink = info.linkStarlink;
+        this.linkWgs = info.linkWgs;
+        this.static = info.static;
+        this.sensorId = info.sensorId;
+        this.url = info.url;
+        this.volume = info.volume;
+        this.zoom = info.zoom;
+        this.band = info.band;
+        this.objName = info.objName;
+        this.uiName = info.uiName;
+        this.system = info.system;
+        this.operator = info.operator;
+    }
+}
+//# sourceMappingURL=DetailedSensor.js.map

package/lib/objects/DetailedSensor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetailedSensor.js","sourceRoot":"","sources":["../../src/objects/DetailedSensor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAoD,MAAM,EAAgB,MAAM,WAAW,CAAC;AAGnG,MAAM,OAAO,cAAe,SAAQ,MAAM;IAuBxC,YAAY,IAA4D;QACtE,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAY,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAY,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC;QACtD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAChC,CAAC;CACF"}

package/{dist/objects/space-object.d.ts → lib/objects/LandObject.d.ts}

@@ -1,13 +1,8 @@
 /**
- * @author Theodore Kruczek.
- * @description Orbital Object ToolKit (OOTK) is a collection of tools for working
- * with satellites and other orbital objects.
- *
- * @file The SpaceObject class is meant to provide properties to satellites/stars that
- * do not apply to ground based objects.
+ * @author @thkruz Theodore Kruczek
  *
  * @license AGPL-3.0-or-later
- * @Copyright (c) 2020-2023 Theodore Kruczek
+ * @Copyright (c) 2020-2024 Theodore Kruczek
  *
  * 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
@@ -20,19 +15,22 @@
  * 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 { BaseObject } from './base-object';
-import { SpaceObjectType } from '../types/types';
-interface ObjectInfo {
-    name?: string;
-    type?: SpaceObjectType;
-    rcs?: number;
-    vmag?: number;
+import { BaseObject, BaseObjectParams, Degrees, Kilometers } from 'ootk-core';
+export interface LandObjectParams {
+    id: number;
+    lat: Degrees;
+    lon: Degrees;
+    alt: Kilometers;
+    country?: string;
+    Code?: string;
 }
-export declare class SpaceObject extends BaseObject {
-    rcs: number;
-    vmag: number;
-    constructor(info: ObjectInfo);
-    getRcs(): number;
-    getVmag(): number;
+export declare class LandObject extends BaseObject {
+    id: number;
+    lat: Degrees;
+    lon: Degrees;
+    alt: Kilometers;
+    country?: string;
+    Code?: string;
+    constructor(info: LandObjectParams & BaseObjectParams);
+    isLandObject(): boolean;
 }
-export {};

package/lib/objects/LandObject.js

@@ -0,0 +1,28 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ *
+ * @license AGPL-3.0-or-later
+ * @Copyright (c) 2020-2024 Theodore Kruczek
+ *
+ * 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 { BaseObject } from 'ootk-core';
+export class LandObject extends BaseObject {
+    constructor(info) {
+        super(info);
+        Object.assign(this, info);
+    }
+    isLandObject() {
+        return true;
+    }
+}
+//# sourceMappingURL=LandObject.js.map

package/lib/objects/LandObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LandObject.js","sourceRoot":"","sources":["../../src/objects/LandObject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAyC,MAAM,WAAW,CAAC;AAY9E,MAAM,OAAO,UAAW,SAAQ,UAAU;IAQxC,YAAY,IAAyC;QACnD,KAAK,CAAC,IAAI,CAAC,CAAC;QAEZ,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/objects/Marker.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ *
+ * @license AGPL-3.0-or-later
+ * @Copyright (c) 2020-2024 Theodore Kruczek
+ *
+ * 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 { BaseObject } from 'ootk-core';
+export declare class Marker extends BaseObject {
+    isMarker(): boolean;
+}

package/lib/objects/Marker.js

@@ -0,0 +1,25 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ *
+ * @license AGPL-3.0-or-later
+ * @Copyright (c) 2020-2024 Theodore Kruczek
+ *
+ * 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 { BaseObject } from 'ootk-core';
+/* eslint-disable class-methods-use-this */
+export class Marker extends BaseObject {
+    isMarker() {
+        return true;
+    }
+}
+//# sourceMappingURL=Marker.js.map

package/lib/objects/Marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Marker.js","sourceRoot":"","sources":["../../src/objects/Marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,2CAA2C;AAE3C,MAAM,OAAO,MAAO,SAAQ,UAAU;IACpC,QAAQ;QACN,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/objects/index.d.ts

@@ -1,4 +1,5 @@
-export { DetailedSat } from './detailed-sat';
-export { Sat } from './sat';
-export { Sensor } from './sensor';
-export { Star } from './star';
+export { BaseObject, Satellite, Sensor, Star } from 'ootk-core';
+export { DetailedSatellite } from './DetailedSatellite';
+export { DetailedSensor } from './DetailedSensor';
+export { LandObject } from './LandObject';
+export { Marker } from './Marker';

package/lib/objects/index.js

@@ -1,5 +1,6 @@
-export { DetailedSat } from './detailed-sat';
-export { Sat } from './sat';
-export { Sensor } from './sensor';
-export { Star } from './star';
+export { BaseObject, Satellite, Sensor, Star } from 'ootk-core';
+export { DetailedSatellite } from './DetailedSatellite';
+export { DetailedSensor } from './DetailedSensor';
+export { LandObject } from './LandObject';
+export { Marker } from './Marker';
 //# sourceMappingURL=index.js.map