ootk-core

/** * @author Theodore Kruczek. * @license MIT * @copyright (c) 2022-2025 Theodore Kruczek Permission is * hereby granted, free of charge, to any person obtaining a copy of this * software and associated documentation files (the "Software"), to deal in the * Software without restriction, including without limitation the rights to use, * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of * the Software, and to permit persons to whom the Software is furnished to do * so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ import type { ClassicalElements } from '../coordinate/index.js'; import { Geodetic } from '../coordinate/Geodetic.js'; import { ITRF } from '../coordinate/ITRF.js'; import { J2000 } from '../coordinate/J2000.js'; import { RIC } from '../coordinate/RIC.js'; import { Tle } from '../coordinate/Tle.js'; import { OptionsParams } from '../interfaces/OptionsParams.js'; import { SatelliteParams } from '../interfaces/SatelliteParams.js'; import { RAE } from '../observation/RAE.js'; import { Degrees, EcfVec3, GreenwichMeanSiderealTime, Kilometers, LlaVec3, Minutes, PosVel, RaeVec3, SatelliteRecord, TleLine1, TleLine2 } from '../types/types.js'; import { BaseObject } from './BaseObject.js'; import { GroundObject } from './GroundObject.js'; /** * Represents a satellite object with orbital information and methods for * calculating its position and other properties. */ export declare class Satellite extends BaseObject { apogee: Kilometers; argOfPerigee: Degrees; bstar: number; eccentricity: number; epochDay: number; epochYear: number; inclination: Degrees; intlDes: string; meanAnomaly: Degrees; meanMoDev1: number; meanMoDev2: number; meanMotion: number; options: OptionsParams; perigee: Kilometers; period: Minutes; rightAscension: Degrees; satrec: SatelliteRecord; /** The satellite catalog number as listed in the TLE. */ sccNum: string; /** The 5 digit alpha-numeric satellite catalog number. */ sccNum5: string; /** The 6 digit numeric satellite catalog number. */ sccNum6: string; tle1: TleLine1; tle2: TleLine2; /** The semi-major axis of the satellite's orbit. */ semiMajorAxis: Kilometers; /** The semi-minor axis of the satellite's orbit. */ semiMinorAxis: Kilometers; constructor(info: SatelliteParams, options?: OptionsParams); private parseTleAndUpdateOrbit_; private parseOmmAndUpdateOrbit_; /** * Checks if the object is a satellite. * @returns True if the object is a satellite, false otherwise. */ isSatellite(): boolean; /** * Returns whether the satellite is static or not. * @returns True if the satellite is static, false otherwise. */ isStatic(): boolean; /** * Checks if the given SatelliteRecord object is valid by checking if its properties are all numbers. * @param satrec - The SatelliteRecord object to check. * @returns True if the SatelliteRecord object is valid, false otherwise. */ static isValidSatrec(satrec: SatelliteRecord): boolean; ageOfElset(nowInput?: Date, outputUnits?: 'days' | 'hours' | 'minutes' | 'seconds'): number; editTle(tle1: TleLine1, tle2: TleLine2, sccNum?: string): void; /** * Calculates the azimuth angle of the satellite relative to the given sensor at the specified date. If no date is * provided, the current time of the satellite is used. * @variation optimized * @param observer - The observer's position on the ground. * @param date - The date at which to calculate the azimuth angle. Optional, defaults to the current date. * @returns The azimuth angle of the satellite relative to the given sensor at the specified date. */ az(observer: GroundObject, date?: Date): Degrees; /** * Calculates the RAE (Range, Azimuth, Elevation) values for a given sensor and date. If no date is provided, the * current time is used. * @variation expanded * @param observer - The observer's position on the ground. * @param date - The date at which to calculate the RAE values. Optional, defaults to the current date. * @returns The RAE values for the given sensor and date. */ toRae(observer: GroundObject, date?: Date): RAE; /** * Calculates ECF position at a given time. * @variation optimized * @param date - The date at which to calculate the ECF position. Optional, defaults to the current date. * @returns The ECF position at the specified date. */ ecf(date?: Date): EcfVec3<Kilometers>; /** * Calculates ECI position at a given time. * @variation optimized * @param date - The date at which to calculate the ECI position. Optional, defaults to the current date. * @param j - Julian date. Optional, defaults to null. * @param gmst - Greenwich Mean Sidereal Time. Optional, defaults to null. * @returns The ECI position at the specified date. */ eci(date?: Date, j?: number, gmst?: GreenwichMeanSiderealTime): PosVel<Kilometers>; /** * Calculates the J2000 coordinates for a given date. If no date is provided, the current time is used. * @variation expanded * @param date - The date for which to calculate the J2000 coordinates, defaults to the current date. * @returns The J2000 coordinates for the specified date. * @throws Error if propagation fails. */ toJ2000(date?: Date): J2000; /** * Returns the elevation angle of the satellite as seen by the given sensor at the specified time. * @variation optimized * @param observer - The observer's position on the ground. * @param date - The date at which to calculate the elevation angle. Optional, defaults to the current date. * @returns The elevation angle of the satellite as seen by the given sensor at the specified time. */ el(observer: GroundObject, date?: Date): Degrees; /** * Calculates LLA position at a given time. * @variation optimized * @param date - The date at which to calculate the LLA position. Optional, defaults to the current date. * @param j - Julian date. Optional, defaults to null. * @param gmst - Greenwich Mean Sidereal Time. Optional, defaults to null. * @returns The LLA position at the specified date. */ lla(date?: Date, j?: number, gmst?: GreenwichMeanSiderealTime): LlaVec3<Degrees, Kilometers>; /** * Converts the satellite's position to geodetic coordinates. * @variation expanded * @param date The date for which to calculate the geodetic coordinates. Defaults to the current date. * @returns The geodetic coordinates of the satellite. */ toGeodetic(date?: Date): Geodetic; /** * Converts the satellite's position to the International Terrestrial Reference Frame (ITRF) at the specified date. * If no date is provided, the current date is used. * @variation expanded * @param date The date for which to convert the position. Defaults to the current date. * @returns The satellite's position in the ITRF at the specified date. */ toITRF(date?: Date): ITRF; /** * Converts the current satellite's position to the Reference-Inertial-Celestial (RIC) frame * relative to the specified reference satellite at the given date. * @variation expanded * @param reference The reference satellite. * @param date The date for which to calculate the RIC frame. Defaults to the current date. * @returns The RIC frame representing the current satellite's position relative to the reference satellite. */ toRIC(reference: Satellite, date?: Date): RIC; /** * Converts the satellite object to a TLE (Two-Line Element) object. * @returns The TLE object representing the satellite. */ toTle(): Tle; /** * Converts the satellite's position to classical orbital elements. * @param date The date for which to calculate the classical elements. Defaults to the current date. * @returns The classical orbital elements of the satellite. */ toClassicalElements(date?: Date): ClassicalElements; /** * Calculates the RAE (Range, Azimuth, Elevation) vector for a given sensor and time. * @variation optimized * @param observer - The observer's position on the ground. * @param date - The date at which to calculate the RAE vector. Optional, defaults to the current date. * @param j - Julian date. Optional, defaults to null. * @param gmst - Greenwich Mean Sidereal Time. Optional, defaults to null. * @returns The RAE vector for the given sensor and time. */ rae(observer: GroundObject, date?: Date, j?: number, gmst?: GreenwichMeanSiderealTime): RaeVec3<Kilometers, Degrees>; /** * Returns the range of the satellite from the given sensor at the specified time. * @variation optimized * @param observer - The observer's position on the ground. * @param date - The date at which to calculate the range. Optional, defaults to the current date. * @returns The range of the satellite from the given sensor at the specified time. */ rng(observer: GroundObject, date?: Date): Kilometers; /** * Applies the Doppler effect to the given frequency based on the observer's position and the date. * @param freq - The frequency to apply the Doppler effect to. * @param observer - The observer's position on the ground. * @param date - The date at which to calculate the Doppler effect. Optional, defaults to the current date. * @returns The frequency after applying the Doppler effect. */ applyDoppler(freq: number, observer: GroundObject, date?: Date): number; /** * Calculates the Doppler factor for the satellite. * @param observer The observer's ground position. * @param date The optional date for which to calculate the Doppler factor. If not provided, the current date is used. * @returns The calculated Doppler factor. */ dopplerFactor(observer: GroundObject, date?: Date): number; /** * Calculates the time variables for a given date relative to the TLE epoch. * @param date Date to calculate * @param satrec Satellite orbital information * @param j Julian date * @param gmst Greenwich Mean Sidereal Time * @returns Time variables */ private static calculateTimeVariables; }