ootk 3.0.0 → 4.0.0-0

package/dist/tle/tle.d.ts

@@ -1,375 +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';
-import { TleFormatData } from './tle-format-data';
-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 {
-    static readonly lineNumber: TleFormatData;
-    static readonly satNum: TleFormatData;
-    static readonly classification: TleFormatData;
-    static readonly intlDes: TleFormatData;
-    static readonly intlDesYear: TleFormatData;
-    static readonly intlDesLaunchNum: TleFormatData;
-    static readonly intlDesLaunchPiece: TleFormatData;
-    static readonly epochYear: TleFormatData;
-    static readonly epochDay: TleFormatData;
-    static readonly meanMoDev1: TleFormatData;
-    static readonly meanMoDev2: TleFormatData;
-    static readonly bstar: TleFormatData;
-    static readonly ephemerisType: TleFormatData;
-    static readonly elsetNum: TleFormatData;
-    static readonly checksum: TleFormatData;
-    static readonly inclination: TleFormatData;
-    static readonly raan: TleFormatData;
-    static readonly eccentricity: TleFormatData;
-    static readonly argPerigee: TleFormatData;
-    static readonly meanAnom: TleFormatData;
-    static readonly meanMo: TleFormatData;
-    static readonly revNum: TleFormatData;
-    /**
-     * 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} tleLine The first line of the TLE to parse.
-     * @returns {number} The checksum value.
-     */
-    static getChecksum(tleLine: TleLine1 | TleLine2): 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,94 +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, EcefVec3, EcfVec3, EciVec3, EnuVec3, Kilometers, LlaVec3, RadarSensor, Radians, RaeVec3, RfVec3, RuvVec3, 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;
-    /**
-     * Calculates Geodetic Lat Lon Alt to ECEF coordinates.
-     */
-    static lla2ecef(lla: LlaVec3): EcefVec3<Kilometers>;
-    static ecf2enu(ecf: EcefVec3<Kilometers>, lla: LlaVec3): EnuVec3<Kilometers>;
-    static rae2enu(rae: RaeVec3): EnuVec3<Kilometers>;
-    static enu2rf({ x, y, z }: EnuVec3<Kilometers>, az: Radians, el: Radians): RfVec3;
-    /**
-     * Converts Azimuth and Elevation to U and V.
-     * Azimuth is the angle off of boresight in the horizontal plane.
-     * Elevation is the angle off of boresight in the vertical plane.
-     * Cone half angle is the angle of the cone of the radar max field of view.
-     */
-    static azel2uv(az: Radians, el: Radians, coneHalfAngle: Radians): {
-        u: Radians;
-        v: Radians;
-    };
-    /**
-     * Converts U and V to Azimuth and Elevation off of boresight.
-     */
-    static uv2azel(u: Radians, v: Radians, coneHalfAngle: Radians): {
-        az: Radians;
-        el: Radians;
-    };
-    /**
-     * Converts Range Az El to Range U V.
-     */
-    static rae2ruv(rae: RaeVec3, sensor: RadarSensor, maxSensorAz: Degrees): RuvVec3;
-    /**
-     * Determine azimuth and elevation off of boresight based on sensor orientation and RAE.
-     *
-     * @param {rae} rae Range, Azimuth, Elevation
-     * @param {RadarSensor} sensor Radar sensor object
-     * @returns {az, el} Azimuth and Elevation off of boresight
-     */
-    static rae2raeOffBoresight(rae: RaeVec3, sensor: RadarSensor, maxSensorAz: Degrees): {
-        az: Radians;
-        el: Radians;
-    };
-}
-export { Transforms };