ootk 2.0.1 → 4.0.0-0

package/dist/ootk.js.LICENSE.txt

@@ -1,77 +0,0 @@
-/**
- * @author Theodore Kruczek.
- * @description Orbital Object ToolKit (OOTK) is a collection of tools for working
- * with satellites and other orbital objects.
- *
- * @file Commonly used constants.
- *
- * @license AGPL-3.0-or-later
- * @Copyright (c) 2020-2023 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/>.
- */
-
-/**
- * @author Theodore Kruczek.
- * @description Orbital Object ToolKit (OOTK) is a collection of tools for working
- * with satellites and other orbital objects.
- *
- * @file SunMath is a collection of functions for calculating the position of the sun
- * and other stars. This was originally created by Vladimir Agafonkin. Robert Gester's
- * update was referenced for documentation. There were a couple of bugs in both versions
- * so there will be some differences if you are migrating from either to this library.
- *
- *
- * @license AGPL-3.0-or-later
- * @Copyright (c) 2020-2023 Theodore Kruczek
- *
- * @Copyright (c) 2011-2015, Vladimir Agafonkin
- * SunCalc is a JavaScript library for calculating sun/moon position and light phases.
- * https://github.com/mourner/suncalc
- *
- * Reworked and enhanced by Robert Gester
- * @Copyright (c) 2022 Robert Gester
- * https://github.com/hypnos3/suncalc3
- *
- * sun calculations are based on http://aa.quae.nl/en/reken/zonpositie.html formulas
- *
- * 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/>.
- */
-
-/**
- * @author Theodore Kruczek.
- * @description Orbital Object ToolKit (OOTK) is a collection of tools for working
- * with satellites and other orbital objects.
- *
- * @license AGPL-3.0-or-later
- * @Copyright (c) 2020-2023 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/>.
- */

package/dist/sgp4/Sgp4Assembly.d.ts

@@ -1,5 +0,0 @@
-export declare class Sgp4Assembly {
-    private module;
-    propagateWasm(): void;
-    loadWasm(path: string): Promise<void>;
-}

package/dist/sgp4/sgp4.d.ts

@@ -1,82 +0,0 @@
-/**
- * @author Theodore Kruczek.
- * @description Orbital Object ToolKit (OOTK) is a collection of tools for working
- * with satellites and other orbital objects.
- *
- * @file The Sgp4 module contains a TypeScript port of the 2020 version of
- * sgp4unit.cpp from "Fundamentals of Astrodynamics and Applications" by David
- * Vallado. All of the original comments and notes are inserted in the code below
- * in order provide context to the functions and clarify any adjustments made for
- * TypeScript/JavaScript compatibility.
- *
- * @license AGPL-3.0-or-later
- * @Copyright (c) 2020-2023 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 { SatelliteRecord, StateVector, Vec3Flat } from '../types/types';
-declare class Sgp4 {
-    static angle(vec1: Vec3Flat, vec2: Vec3Flat): number;
-    static asinh(xval: number): number;
-    static createSatrec(tleLine1: string, tleLine2: string, whichconst?: string, opsmode?: string): SatelliteRecord;
-    static cross(vec1: Vec3Flat, vec2: Vec3Flat): Vec3Flat;
-    static days2mdhms(year: number, days: number): {
-        mon: number;
-        day: number;
-        hr: number;
-        min: number;
-        sec: number;
-    };
-    static dot(x: Vec3Flat, y: Vec3Flat): number;
-    static gstime(jdut1: number): number;
-    static invjday(jd: number, jdfrac: number): {
-        year: number;
-        mon: number;
-        day: number;
-        hr: number;
-        min: number;
-        sec: number;
-    };
-    static jday(year: number | Date, mon?: number, day?: number, hr?: number, min?: number, sec?: number, ms?: number): {
-        jd: number;
-        jdFrac: number;
-    };
-    static mag(x: Vec3Flat): number;
-    static newtonnu(ecc: number, nu: number): {
-        e0: number;
-        m: number;
-    };
-    static propagate(satrec: SatelliteRecord, tsince: number): StateVector;
-    static rv2coe(r: Vec3Flat, v: Vec3Flat, mus: number): {
-        p: number;
-        a: number;
-        ecc: number;
-        incl: number;
-        omega: number;
-        argp: number;
-        nu: number;
-        m: number;
-        arglat: number;
-        truelon: number;
-        lonper: number;
-    };
-    static sgn(x: number): number;
-    static sinh(x: number): number;
-    private static dpper;
-    private static dscom;
-    private static dsinit;
-    private static dspace;
-    private static getgravconst;
-    private static initl;
-    private static sgp4init;
-}
-export { Sgp4 };

package/dist/tle/tle-format-data.d.ts

@@ -1,6 +0,0 @@
-export declare class TleFormatData {
-    start: number;
-    stop: number;
-    length: number;
-    constructor(start: number, end: number);
-}

package/dist/tle/tle.d.ts

@@ -1,374 +0,0 @@
-/**
- * @author Theodore Kruczek.
- * @description Orbital Object ToolKit (OOTK) is a collection of tools for working
- * with satellites and other orbital objects.
- *
- * @file The TLE module contains a collection of functions for working with TLEs.
- *
- * @license AGPL-3.0-or-later
- * @Copyright (c) 2020-2023 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 { Line1Data, Line2Data, TleLine1, TleLine2 } from '../types/types';
-type TleData = {
-    satNum: number;
-    intlDes: string;
-    epochYear: number;
-    epochDay: number;
-    meanMoDev1: number;
-    meanMoDev2: number;
-    bstar: number;
-    inclination: number;
-    raan: number;
-    eccentricity: number;
-    argOfPerigee: number;
-    meanAnomaly: number;
-    meanMotion: number;
-};
-type TleDataFull = Line1Data & Line2Data;
-export declare class Tle {
-    private static lineNumber;
-    private static satNum;
-    private static classification;
-    private static intlDes;
-    private static intlDesYear;
-    private static intlDesLaunchNum;
-    private static intlDesLaunchPiece;
-    private static epochYear;
-    private static epochDay;
-    private static meanMoDev1;
-    private static meanMoDev2;
-    private static bstar;
-    private static ephemerisType;
-    private static elsetNum;
-    private static checksum;
-    private static inclination;
-    private static raan;
-    private static eccentricity;
-    private static argPerigee;
-    private static meanAnom;
-    private static meanMo;
-    private static revNum;
-    /**
-     * Parses the TLE into orbital data.
-     *
-     * If you want all of the data then use parseTleFull instead.
-     * @param {TleLine1} tleLine1 TLE line 1
-     * @param {TleLine2} tleLine2 TLE line 2
-     * @returns {TleData} Returns most commonly used orbital data from TLE
-     */
-    static parseTle(tleLine1: TleLine1, tleLine2: TleLine2): TleData;
-    /**
-     * Parses all of the data contained in the TLE.
-     *
-     * If you only want the most commonly used data then use parseTle instead.
-     * @param {TleLine1} tleLine1 The first line of the TLE to parse.
-     * @param {TleLine2} tleLine2 The second line of the TLE to parse.
-     * @returns {TleDataFull} Returns all of the data from the TLE.
-     */
-    static parseTleFull(tleLine1: TleLine1, tleLine2: TleLine2): TleDataFull;
-    /**
-     * Parse the first line of the TLE.
-     * @param {TleLine1} tleLine1 The first line of the TLE to parse.
-     * @returns {Line1Data} Returns the data from the first line of the TLE.
-     */
-    static parseLine1(tleLine1: TleLine1): Line1Data;
-    /**
-     * Parse the second line of the TLE.
-     * @param {TleLine2} tleLine2 The second line of the TLE to parse.
-     * @returns {Line2Data} Returns the data from the second line of the TLE.
-     */
-    static parseLine2(tleLine2: TleLine2): Line2Data;
-    /**
-     * This should always return a 1 or a 2.
-     * @param {string} tleLine The first line of the TLE to parse.
-     * @returns {number} The line number of the TLE.
-     */
-    static getLineNumber(tleLine: TleLine1 | TleLine2): 1 | 2;
-    /**
-     * See https://en.wikipedia.org/wiki/Satellite_Catalog_Number
-     *
-     * Range: 0 to 99999 or 26999.
-     *
-     * NOTE: To support Alpha-5, the first digit can be a letter.
-     * This will be converted to a number in order to expand the range to 26999.
-     *
-     * Example: 25544 or B1234 (e.g. Sputnik's rocket body was number 00001)
-     *
-     * @param {string} tleLine The first line of the TLE to parse.
-     * @returns {number} NORAD catalog number.
-     */
-    static getSatNum(tleLine: TleLine1 | TleLine2): number;
-    /**
-     * See https://en.wikipedia.org/wiki/Satellite_Catalog_Number
-     *
-     * Range: 0 to 99999 or 26999.
-     *
-     * NOTE: To support Alpha-5, the first digit can be a letter.
-     * This will NOT be converted to a number. Use getSatNum() for that.
-     *
-     * Example: 25544 or B1234 (e.g. Sputnik's rocket body was number 00001)
-     *
-     * @param {string} tleLine The first line of the TLE to parse.
-     * @returns {string} NORAD catalog number.
-     */
-    static getRawSatNum(tleLine: TleLine1 | TleLine2): string;
-    /**
-     * Satellite classification.
-     * * 'U' = unclassified
-     * * 'C' = confidential
-     * * 'S' = secret
-     *
-     * Example: 'U'
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {string} The classification.
-     */
-    static getClassification(tleLine1: TleLine1): string;
-    /**
-     * International Designator (COSPAR ID)
-     * See https://en.wikipedia.org/wiki/International_Designator
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {string} The International Designator.
-     */
-    static getIntlDes(tleLine1: TleLine1): string;
-    /**
-     * International Designator (COSPAR ID): Last 2 digits of launch year.
-     *
-     * Range: 00 to 99
-     *
-     * Example: 98
-     *
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {number} The year of the International Designator.
-     */
-    static getIntlDesYear(tleLine1: TleLine1): number;
-    /**
-     * International Designator (COSPAR ID): Launch number of the year.
-     *
-     * Range: 1 to 999
-     *
-     * Example: 67
-     *
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {number} The launch number of the International Designator.
-     */
-    static getIntlDesLaunchNum(tleLine1: string): number;
-    /**
-     * International Designator  (COSPAR ID): Piece of the launch.
-     *
-     * Range: A to ZZZ
-     *
-     * Example: 'A'
-     *
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {string} The launch piece of the International Designator.
-     */
-    static getIntlDesLaunchPiece(tleLine1: TleLine1): string;
-    /**
-     * Year when the TLE was generated (TLE epoch), last two digits.
-     *
-     * Range: 00 to 99
-     *
-     * Example: 17
-     *
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {number} The year the TLE was generated.
-     */
-    static getEpochYear(tleLine1: TleLine1): number;
-    /**
-     * Year when the TLE was generated (TLE epoch), four digits.
-     *
-     * Range: 1957 to 2056
-     *
-     * Example: 2008
-     *
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {number} The year the TLE was generated.
-     */
-    static getEpochYearFull(tleLine1: TleLine1): number;
-    /**
-     * Fractional day of the year when the TLE was generated (TLE epoch).
-     *
-     * Range: 1 to 365.99999999
-     *
-     * Example: 206.18396726
-     *
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {number} The day of the year the TLE was generated.
-     */
-    static getEpochDay(tleLine1: string): number;
-    /**
-     * First Time Derivative of the Mean Motion divided by two.  Defines how mean motion changes
-     * over time, so TLE propagators can still be used to make reasonable guesses when
-     * times are distant from the original TLE epoch.
-     *
-     * Units: Orbits / day ^ 2
-     *
-     * Example: 0.00001961
-     *
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {number} The first derivative of the mean motion.
-     */
-    static getMeanMoDev1(tleLine1: TleLine1): number;
-    /**
-     * Second Time Derivative of Mean Motion divided by six (decimal point assumed). Measures rate
-     * of change in the Mean Motion Dot so software can make reasonable guesses when times are
-     * distant from the original TLE epoch.
-     *
-     * Usually zero, unless the satellite is manuevering or in a decaying orbit.
-     *
-     * Units: Orbits / day ^ 3.
-     *
-     * Example: 0 ('00000-0' in the original TLE [= 0.00000 * 10 ^ 0])
-     *
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {number} The second derivative of the mean motion.
-     */
-    static getMeanMoDev2(tleLine1: string): number;
-    /**
-     * BSTAR drag term (decimal point assumed).  Estimates the effects of
-     * atmospheric drag on the satellite's motion.
-     *
-     * Units: EarthRadii ^ -1
-     *
-     * Example: 0.000036771 ('36771-4' in the original TLE [= 0.36771 * 10 ^ -4])
-     *
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {number} The drag coefficient.
-     */
-    static getBstar(tleLine1: TleLine1): number;
-    /**
-     * Private value - used by United States Space Force to reference the orbit model used to
-     * generate the TLE.  Will always be seen as zero externally (e.g. by "us", unless you are
-     * "them" - in which case, hello!).
-     *
-     * Example: 0
-     *
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {number} The ephemeris type.
-     */
-    static getEphemerisType(tleLine1: TleLine1): number;
-    /**
-     * TLE element set number, incremented for each new TLE generated. 999 seems to mean the TLE
-     * has maxed out.
-     *
-     * Range: Technically 1 to 9999, though in practice the maximum number seems to be 999.
-     *
-     * Example: 999
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {number} The element number.
-     */
-    static getElsetNum(tleLine1: TleLine1): number;
-    /**
-     * TLE line 1 checksum (modulo 10), for verifying the integrity of this line of the TLE.
-     *
-     * Range: 0 to 9
-     * Example: 3
-     *
-     * @param {string} tleLine1 The first line of the TLE to parse.
-     * @returns {number} The checksum value.
-     */
-    static getChecksum(tleLine1: TleLine1): number;
-    /**
-     * Inclination relative to the Earth's equatorial plane in degrees. 0 to 90 degrees is a
-     * prograde orbit and 90 to 180 degrees is a retrograde orbit.
-     *
-     * Units: degrees
-     *
-     * Range: 0 to 180
-     *
-     * Example: 51.6400
-     *
-     * @param {string} tleLine2 The second line of the TLE to parse.
-     * @returns {number} The inclination of the satellite.
-     */
-    static getInclination(tleLine2: TleLine2): number;
-    /**
-     * Right ascension of the ascending node in degrees. Essentially, this is the angle of the
-     * satellite as it crosses northward (ascending) across the Earth's equator (equatorial
-     * plane).
-     *
-     * Units: degrees
-     *
-     * Range: 0 to 359.9999
-     *
-     * Example: 208.9163
-     *
-     * @param {string} tleLine2 The second line of the TLE to parse.
-     * @returns {number} The right ascension of the satellite.
-     */
-    static getRaan(tleLine2: TleLine2): number;
-    /**
-     * Orbital eccentricity, decimal point assumed. All artificial Earth satellites have an
-     * eccentricity between 0 (perfect circle) and 1 (parabolic orbit).
-     *
-     * Range: 0 to 1
-     *
-     * Example: 0.0006317 (`0006317` in the original TLE)
-     *
-     * @param {string} tleLine2 The second line of the TLE to parse.
-     * @returns {number} The eccentricity of the satellite.
-     */
-    static getEccentricity(tleLine2: TleLine2): number;
-    /**
-     * Argument of perigee. See https://en.wikipedia.org/wiki/Argument_of_perigee
-     *
-     * Units: degrees
-     *
-     * Range: 0 to 359.9999
-     *
-     * Example: 69.9862
-     *
-     * @param {string} tleLine2 The second line of the TLE to parse.
-     * @returns {number} The argument of perigee in degrees.
-     */
-    static getArgOfPerigee(tleLine2: TleLine2): number;
-    /**
-     * Mean anomaly. Indicates where the satellite was located within its orbit at the time of the
-     * TLE epoch.
-     * See https://en.wikipedia.org/wiki/Mean_Anomaly
-     *
-     * Units: degrees
-     *
-     * Range: 0 to 359.9999
-     *
-     * Example: 25.2906
-     *
-     * @param {string} tleLine2 The second line of the TLE to parse.
-     * @returns {number} The mean anomaly of the satellite.
-     */
-    static getMeanAnomaly(tleLine2: TleLine2): number;
-    /**
-     * Revolutions around the Earth per day (mean motion).
-     * See https://en.wikipedia.org/wiki/Mean_Motion
-     *
-     * Range: 0 to 17 (theoretically)
-     * Example: 15.54225995
-     * @param {string} tleLine2 The second line of the TLE to parse.
-     * @returns {number} The mean motion of the satellite.
-     */
-    static getMeanMotion(tleLine2: TleLine2): number;
-    /**
-     * Total satellite revolutions when this TLE was generated. This number rolls over
-     * (e.g. 99999 -> 0).
-     *
-     * Range: 0 to 99999
-     *
-     * Example: 6766
-     *
-     * @param {string} tleLine2 The second line of the TLE to parse.
-     * @returns {number} The revolutions around the Earth per day (mean motion).
-     */
-    static getRevNum(tleLine2: TleLine2): number;
-}
-export {};

package/dist/transforms/transforms.d.ts

@@ -1,55 +0,0 @@
-/**
- * @author Theodore Kruczek.
- * @description Orbital Object ToolKit (OOTK) is a collection of tools for working
- * with satellites and other orbital objects.
- *
- * @file The Transforms module contains a collection of conversions not contained
- * in the original SGP4 library such as ECI to ECF and ECF to RAE. This was based
- * on some of the functions in satellite.js.
- *
- * @license AGPL-3.0-or-later
- * @Copyright (c) 2020-2023 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 { Degrees, EcfVec3, EciVec3, LlaVec3, Radians, RaeVec3, SezVec3 } from '../types/types';
-declare class Transforms {
-    static getDegLat(radians: Radians): Degrees;
-    static getDegLon(radians: Radians): Degrees;
-    static getRadLat(degrees: Degrees): Radians;
-    static getRadLon(degrees: Degrees): Radians;
-    static rad2deg(radians: Radians): Degrees;
-    static deg2rad(degrees: Degrees): Radians;
-    static ecf2eci(ecf: EcfVec3, gmst: number): EciVec3;
-    static ecf2rae(lla: LlaVec3, ecf: EcfVec3): RaeVec3;
-    /**
-     * EciToGeodetic converts eci coordinates to lla coordinates
-     * @param {vec3} eci takes xyz coordinates
-     * @param {number} gmst takes a number in gmst time
-     * @returns {array} array containing lla coordinates
-     */
-    static eci2lla(eci: EciVec3, gmst: number): LlaVec3;
-    static eci2ecf(eci: EciVec3, gmst: number): EcfVec3;
-    static lla2ecf(lla: LlaVec3): EcfVec3;
-    static lla2sez(lla: LlaVec3, ecf: EcfVec3): SezVec3;
-    static rae2sez(rae: RaeVec3): SezVec3;
-    static rae2ecf(rae: RaeVec3, lla: LlaVec3): EcfVec3;
-    /**
-     * @param {Object} sez Containing SEZ coordinates
-     * @param {Number} sez.s Positive horizontal vector S due south.
-     * @param {Number} sez.e Positive horizontal vector E due east.
-     * @param {Number} sez.z Vector Z normal to the surface of the earth (up).
-     * @returns {RaeVec3} Rng, Az, El array
-     */
-    static sez2rae(sez: SezVec3): RaeVec3;
-}
-export { Transforms };