ootk 1.0.8 → 1.5.1

package/lib/{transforms.js → transforms/transforms.js}

@@ -1,3 +1,4 @@
+/* eslint-disable init-declarations */
 /**
  * @author Theodore Kruczek.
  * @description Orbital Object ToolKit (OOTK) is a collection of tools for working
@@ -7,25 +8,21 @@
  * 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.
  *
- * 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:
+ * @license AGPL-3.0-or-later
+ * @Copyright (c) 2020-2022 Theodore Kruczek
  *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
+ * 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.
  *
- * 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.
+ * 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 { PI, TAU } from './utils/constants';
+import { PI, TAU } from '../utils/constants';
 var Transforms = /** @class */ (function () {
     function Transforms() {
     }
@@ -60,12 +57,14 @@ var Transforms = /** @class */ (function () {
         return (degrees * PI) / 180.0;
     };
     Transforms.ecf2eci = function (ecf, gmst) {
-        // ccar.colorado.edu/ASEN5070/handouts/coordsys.doc
-        //
-        // [X]     [C -S  0][X]
-        // [Y]  =  [S  C  0][Y]
-        // [Z]eci  [0  0  1][Z]ecf
-        //
+        /*
+         * Ccar.colorado.edu/ASEN5070/handouts/coordsys.doc
+         *
+         * [X]     [C -S  0][X]
+         * [Y]  =  [S  C  0][Y]
+         * [Z]eci  [0  0  1][Z]ecf
+         *
+         */
         var X = ecf.x * Math.cos(gmst) - ecf.y * Math.sin(gmst);
         var Y = ecf.x * Math.sin(gmst) + ecf.y * Math.cos(gmst);
         var Z = ecf.z;
@@ -75,7 +74,8 @@ var Transforms = /** @class */ (function () {
         var sezCoords = Transforms.lla2sez(lla, ecf);
         return Transforms.sez2rae(sezCoords);
     };
-    /** eciToGeodetic converts eci coordinates to lla coordinates
+    /**
+     * 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
@@ -107,17 +107,19 @@ var Transforms = /** @class */ (function () {
         return { lon: lon, lat: lat, alt: alt };
     };
     Transforms.eci2ecf = function (eci, gmst) {
-        // ccar.colorado.edu/ASEN5070/handouts/coordsys.doc
-        //
-        // [X]     [C -S  0][X]
-        // [Y]  =  [S  C  0][Y]
-        // [Z]eci  [0  0  1][Z]ecf
-        //
-        //
-        // Inverse:
-        // [X]     [C  S  0][X]
-        // [Y]  =  [-S C  0][Y]
-        // [Z]ecf  [0  0  1][Z]eci
+        /*
+         * Ccar.colorado.edu/ASEN5070/handouts/coordsys.doc
+         *
+         * [X]     [C -S  0][X]
+         * [Y]  =  [S  C  0][Y]
+         * [Z]eci  [0  0  1][Z]ecf
+         *
+         *
+         * Inverse:
+         * [X]     [C  S  0][X]
+         * [Y]  =  [-S C  0][Y]
+         * [Z]ecf  [0  0  1][Z]eci
+         */
         var x = eci.x * Math.cos(gmst) + eci.y * Math.sin(gmst);
         var y = eci.x * -Math.sin(gmst) + eci.y * Math.cos(gmst);
         var z = eci.z;
@@ -144,22 +146,24 @@ var Transforms = /** @class */ (function () {
         };
     };
     Transforms.lla2sez = function (lla, ecf) {
-        // http://www.celestrak.com/columns/v02n02/
-        // TS Kelso's method, except I'm using ECF frame
-        // and he uses ECI.
+        /*
+         * http://www.celestrak.com/columns/v02n02/
+         * TS Kelso's method, except I'm using ECF frame
+         * and he uses ECI.
+         */
         var lon = lla.lon, lat = lla.lat;
         var observerEcf = Transforms.lla2ecf(lla);
         var rx = ecf.x - observerEcf.x;
         var ry = ecf.y - observerEcf.y;
         var rz = ecf.z - observerEcf.z;
-        // top is short for topocentric
+        // Top is short for topocentric
         var south = Math.sin(lat) * Math.cos(lon) * rx + Math.sin(lat) * Math.sin(lon) * ry - Math.cos(lat) * rz;
         var east = -Math.sin(lon) * rx + Math.cos(lon) * ry;
         var zenith = Math.cos(lat) * Math.cos(lon) * rx + Math.cos(lat) * Math.sin(lon) * ry + Math.sin(lat) * rz;
         return { s: south, e: east, z: zenith };
     };
     Transforms.rae2sez = function (rae) {
-        // az,el,range to sez convertion
+        // Az,el,range to sez convertion
         var south = -rae.rng * Math.cos(rae.el) * Math.cos(rae.az);
         var east = rae.rng * Math.cos(rae.el) * Math.sin(rae.az);
         var zenith = rae.rng * Math.sin(rae.el);
@@ -172,7 +176,7 @@ var Transforms = /** @class */ (function () {
     Transforms.rae2ecf = function (rae, lla) {
         var obsEcf = Transforms.lla2ecf(lla);
         var sez = Transforms.rae2sez(rae);
-        // some needed calculations
+        // Some needed calculations
         var slat = Math.sin(lla.lat);
         var slon = Math.sin(lla.lon);
         var clat = Math.cos(lla.lat);

package/lib/transforms/transforms.js.map

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

package/lib/{types.d.ts → types/types.d.ts}

@@ -1,4 +1,6 @@
 export declare type Kilometer = number;
+export declare type Radians = number;
+export declare type Degrees = number;
 export declare type Vec3<Type> = {
     x: Type;
     y: Type;
@@ -25,9 +27,11 @@ export declare type SezVec3 = {
     e: Kilometer;
     z: Kilometer;
 };
-export declare type Radians = number;
-export declare type Degrees = number;
-/** @interface SatelliteRecord contains all of the orbital parameters necessary for running SGP4. It is generated by Sgp4.createSatrec.*/
+/**
+ * @interface SatelliteRecord contains all of the orbital parameters necessary for running SGP4.
+ * It is generated by Sgp4.createSatrec.
+ *
+ */
 export interface SatelliteRecord {
     a: number;
     am: number;
@@ -162,3 +166,107 @@ export declare type StateVector = {
 };
 /** @typedef Vec3Flat is a flat three dimensional array used in vector math.*/
 export declare type Vec3Flat = [number, number, number];
+/** @typedef TleLine1 is the first line of a two line element set */
+export declare type TleLine1 = string;
+/** @typedef TleLine2 is the second line of a two line element set */
+export declare type TleLine2 = string;
+export declare type Line1Data = {
+    lineNumber1: number;
+    satNum: number;
+    satNumRaw: string;
+    classification: string;
+    intlDes: string;
+    intlDesYear: number;
+    intlDesLaunchNum: number;
+    intlDesLaunchPiece: string;
+    epochYear: number;
+    epochYearFull: number;
+    epochDay: number;
+    meanMoDev1: number;
+    meanMoDev2: number;
+    bstar: number;
+    ephemerisType: number;
+    elsetNum: number;
+    checksum1: number;
+};
+export declare type Line2Data = {
+    lineNumber2: number;
+    satNum: number;
+    satNumRaw: string;
+    inclination: number;
+    raan: number;
+    eccentricity: number;
+    argOfPerigee: number;
+    meanAnomaly: number;
+    meanMotion: number;
+    revNum: number;
+    checksum2: number;
+};
+export declare enum SpaceObjectType {
+    UNKNOWN = 0,
+    PAYLOAD = 1,
+    ROCKET_BODY = 2,
+    DEBRIS = 3,
+    SPECIAL = 4,
+    RADAR_MEASUREMENT = 5,
+    RADAR_TRACK = 6,
+    RADAR_OBJECT = 7,
+    BALLISTIC_MISSILE = 8,
+    STAR = 9,
+    INTERGOVERNMENTAL_ORGANIZATION = 10,
+    SUBORBITAL_PAYLOAD_OPERATOR = 11,
+    PAYLOAD_OWNER = 12,
+    METEOROLOGICAL_ROCKET_LAUNCH_AGENCY_OR_MANUFACTURER = 13,
+    PAYLOAD_MANUFACTURER = 14,
+    LAUNCH_AGENCY = 15,
+    LAUNCH_SITE = 16,
+    LAUNCH_POSITION = 17,
+    LAUNCH_FACILITY = 18,
+    CONTROL_FACILITY = 19,
+    GROUND_SENSOR_STATION = 20,
+    OPTICAL = 21,
+    MECHANICAL = 22,
+    PHASED_ARRAY_RADAR = 23,
+    OBSERVER = 24,
+    BISTATIC_RADIO_TELESCOPE = 25,
+    COUNTRY = 26,
+    LAUNCH_VEHICLE_MANUFACTURER = 27,
+    ENGINE_MANUFACTURER = 28
+}
+export declare type GreenwichMeanSiderealTime = number;
+export declare type LaunchDetails = {
+    launchDate?: string;
+    launchMass?: string;
+    launchSite?: string;
+    launchVehicle?: string;
+};
+export declare type SpaceCraftDetails = {
+    lifetime?: string | number;
+    maneuver?: string;
+    manufacturer?: string;
+    motor?: string;
+    power?: string;
+    payload?: string;
+    purpose?: string;
+    shape?: string;
+    span?: string;
+    bus?: string;
+    configuration?: string;
+    equipment?: string;
+    dryMass?: string;
+};
+export declare type OperationsDetails = {
+    user?: string;
+    mission?: string;
+    owner?: string;
+    country?: string;
+};
+export declare type AzEl = {
+    az: Radians;
+    el: Radians;
+};
+export declare type Meters = number;
+export declare type SunTime = {
+    solarNoon: Date;
+    nadir: Date;
+};

package/lib/types/types.js

@@ -0,0 +1,34 @@
+// eslint-disable-next-line no-shadow
+export var SpaceObjectType;
+(function (SpaceObjectType) {
+    SpaceObjectType[SpaceObjectType["UNKNOWN"] = 0] = "UNKNOWN";
+    SpaceObjectType[SpaceObjectType["PAYLOAD"] = 1] = "PAYLOAD";
+    SpaceObjectType[SpaceObjectType["ROCKET_BODY"] = 2] = "ROCKET_BODY";
+    SpaceObjectType[SpaceObjectType["DEBRIS"] = 3] = "DEBRIS";
+    SpaceObjectType[SpaceObjectType["SPECIAL"] = 4] = "SPECIAL";
+    SpaceObjectType[SpaceObjectType["RADAR_MEASUREMENT"] = 5] = "RADAR_MEASUREMENT";
+    SpaceObjectType[SpaceObjectType["RADAR_TRACK"] = 6] = "RADAR_TRACK";
+    SpaceObjectType[SpaceObjectType["RADAR_OBJECT"] = 7] = "RADAR_OBJECT";
+    SpaceObjectType[SpaceObjectType["BALLISTIC_MISSILE"] = 8] = "BALLISTIC_MISSILE";
+    SpaceObjectType[SpaceObjectType["STAR"] = 9] = "STAR";
+    SpaceObjectType[SpaceObjectType["INTERGOVERNMENTAL_ORGANIZATION"] = 10] = "INTERGOVERNMENTAL_ORGANIZATION";
+    SpaceObjectType[SpaceObjectType["SUBORBITAL_PAYLOAD_OPERATOR"] = 11] = "SUBORBITAL_PAYLOAD_OPERATOR";
+    SpaceObjectType[SpaceObjectType["PAYLOAD_OWNER"] = 12] = "PAYLOAD_OWNER";
+    SpaceObjectType[SpaceObjectType["METEOROLOGICAL_ROCKET_LAUNCH_AGENCY_OR_MANUFACTURER"] = 13] = "METEOROLOGICAL_ROCKET_LAUNCH_AGENCY_OR_MANUFACTURER";
+    SpaceObjectType[SpaceObjectType["PAYLOAD_MANUFACTURER"] = 14] = "PAYLOAD_MANUFACTURER";
+    SpaceObjectType[SpaceObjectType["LAUNCH_AGENCY"] = 15] = "LAUNCH_AGENCY";
+    SpaceObjectType[SpaceObjectType["LAUNCH_SITE"] = 16] = "LAUNCH_SITE";
+    SpaceObjectType[SpaceObjectType["LAUNCH_POSITION"] = 17] = "LAUNCH_POSITION";
+    SpaceObjectType[SpaceObjectType["LAUNCH_FACILITY"] = 18] = "LAUNCH_FACILITY";
+    SpaceObjectType[SpaceObjectType["CONTROL_FACILITY"] = 19] = "CONTROL_FACILITY";
+    SpaceObjectType[SpaceObjectType["GROUND_SENSOR_STATION"] = 20] = "GROUND_SENSOR_STATION";
+    SpaceObjectType[SpaceObjectType["OPTICAL"] = 21] = "OPTICAL";
+    SpaceObjectType[SpaceObjectType["MECHANICAL"] = 22] = "MECHANICAL";
+    SpaceObjectType[SpaceObjectType["PHASED_ARRAY_RADAR"] = 23] = "PHASED_ARRAY_RADAR";
+    SpaceObjectType[SpaceObjectType["OBSERVER"] = 24] = "OBSERVER";
+    SpaceObjectType[SpaceObjectType["BISTATIC_RADIO_TELESCOPE"] = 25] = "BISTATIC_RADIO_TELESCOPE";
+    SpaceObjectType[SpaceObjectType["COUNTRY"] = 26] = "COUNTRY";
+    SpaceObjectType[SpaceObjectType["LAUNCH_VEHICLE_MANUFACTURER"] = 27] = "LAUNCH_VEHICLE_MANUFACTURER";
+    SpaceObjectType[SpaceObjectType["ENGINE_MANUFACTURER"] = 28] = "ENGINE_MANUFACTURER";
+})(SpaceObjectType || (SpaceObjectType = {}));
+//# sourceMappingURL=types.js.map

package/lib/types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types/types.ts"],"names":[],"mappings":"AA0NA,qCAAqC;AACrC,MAAM,CAAN,IAAY,eA8BX;AA9BD,WAAY,eAAe;IACzB,2DAAW,CAAA;IACX,2DAAW,CAAA;IACX,mEAAe,CAAA;IACf,yDAAU,CAAA;IACV,2DAAW,CAAA;IACX,+EAAqB,CAAA;IACrB,mEAAe,CAAA;IACf,qEAAgB,CAAA;IAChB,+EAAqB,CAAA;IACrB,qDAAQ,CAAA;IACR,0GAAmC,CAAA;IACnC,oGAAgC,CAAA;IAChC,wEAAkB,CAAA;IAClB,oJAAwD,CAAA;IACxD,sFAAyB,CAAA;IACzB,wEAAkB,CAAA;IAClB,oEAAgB,CAAA;IAChB,4EAAoB,CAAA;IACpB,4EAAoB,CAAA;IACpB,8EAAqB,CAAA;IACrB,wFAA0B,CAAA;IAC1B,4DAAY,CAAA;IACZ,kEAAe,CAAA;IACf,kFAAuB,CAAA;IACvB,8DAAa,CAAA;IACb,8FAA6B,CAAA;IAC7B,4DAAY,CAAA;IACZ,oGAAgC,CAAA;IAChC,oFAAwB,CAAA;AAC1B,CAAC,EA9BW,eAAe,KAAf,eAAe,QA8B1B"}

package/lib/utils/constants.d.ts

@@ -5,26 +5,30 @@
  *
  * @file Commonly used constants.
  *
- * 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:
+ * @license AGPL-3.0-or-later
+ * @Copyright (c) 2020-2022 Theodore Kruczek
  *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
+ * 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.
  *
- * 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.
+ * 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/>.
  */
 export declare const PI: number;
 export declare const TAU: number;
 export declare const DEG2RAD: number;
 export declare const x2o3: number;
 export declare const temp4 = 1.5e-12;
+export declare const RAD2DEG: number;
+export declare const MINUTES_PER_DAY = 1440;
+export declare const MS_PER_DAY = 86400000;
+export declare const DAY_TO_MS = 1.15741e-8;
+export declare const cMPerSec = 299792458;
+export declare const cKmPerSec: number;
+export declare const cKmPerMs: number;
+export declare const RADIUS_OF_EARTH = 6371;

package/lib/utils/constants.js

@@ -5,27 +5,31 @@
  *
  * @file Commonly used constants.
  *
- * 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:
+ * @license AGPL-3.0-or-later
+ * @Copyright (c) 2020-2022 Theodore Kruczek
  *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
+ * 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.
  *
- * 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.
+ * 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/>.
  */
 export var PI = Math.PI;
-export var TAU = PI * 2; //https://tauday.com/tau-manifesto
+export var TAU = PI * 2; // https://tauday.com/tau-manifesto
 export var DEG2RAD = PI / 180.0;
 export var x2o3 = 2.0 / 3.0;
 export var temp4 = 1.5e-12;
+export var RAD2DEG = 360 / TAU;
+export var MINUTES_PER_DAY = 1440;
+export var MS_PER_DAY = 86400000;
+export var DAY_TO_MS = 1.15741e-8;
+export var cMPerSec = 299792458;
+export var cKmPerSec = 299792458 / 1000;
+export var cKmPerMs = 299792458 / 1000 / 1000;
+export var RADIUS_OF_EARTH = 6371; // Radius of Earth in kilometers
 //# sourceMappingURL=constants.js.map

package/lib/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,CAAC,IAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;AAC1B,MAAM,CAAC,IAAM,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,kCAAkC;AAC7D,MAAM,CAAC,IAAM,OAAO,GAAG,EAAE,GAAG,KAAK,CAAC;AAClC,MAAM,CAAC,IAAM,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC;AAC9B,MAAM,CAAC,IAAM,KAAK,GAAG,OAAO,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,CAAS,IAAA,EAAE,GAAK,IAAI,GAAT,CAAU;AAC3B,MAAM,CAAC,IAAM,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,mCAAmC;AAC9D,MAAM,CAAC,IAAM,OAAO,GAAG,EAAE,GAAG,KAAK,CAAC;AAClC,MAAM,CAAC,IAAM,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC;AAC9B,MAAM,CAAC,IAAM,KAAK,GAAG,OAAO,CAAC;AAE7B,MAAM,CAAC,IAAM,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC;AACjC,MAAM,CAAC,IAAM,eAAe,GAAG,IAAI,CAAC;AACpC,MAAM,CAAC,IAAM,UAAU,GAAG,QAAQ,CAAC;AACnC,MAAM,CAAC,IAAM,SAAS,GAAG,UAAU,CAAC;AACpC,MAAM,CAAC,IAAM,QAAQ,GAAG,SAAS,CAAC;AAClC,MAAM,CAAC,IAAM,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;AAC1C,MAAM,CAAC,IAAM,QAAQ,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;AAChD,MAAM,CAAC,IAAM,eAAe,GAAG,IAAI,CAAC,CAAC,gCAAgC"}

package/lib/utils/moon-math.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @author Theodore Kruczek.
+ * @description Orbital Object ToolKit (OOTK) is a collection of tools for working
+ * with satellites and other orbital objects.
+ *
+ * @file MoonMath is a an extension to SunMath for calculating the position of the moon
+ * and its phases. 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-2022 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
+ *
+ * moon calculations, based on http://aa.quae.nl/en/reken/hemelpositie.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/>.
+ */
+import { Radians } from '../ootk';
+declare type MoonIlluminationData = {
+    fraction: number;
+    phase: any;
+    phaseValue: number;
+    angle: any;
+    next: {
+        value: number;
+        date: string;
+        type: string;
+        newMoon: {
+            value: any;
+            date: string;
+        };
+        fullMoon: {
+            value: any;
+            date: string;
+        };
+        firstQuarter: {
+            value: any;
+            date: string;
+        };
+        thirdQuarter: {
+            value: any;
+            date: string;
+        };
+    };
+};
+export declare class MoonMath {
+    static moonCoords(d: any): {
+        ra: number;
+        dec: number;
+        dist: number;
+    };
+    static hoursLater(date: Date, h: number): Date;
+    static getMoonPosition(date: any, lat: any, lon: any): {
+        az: number;
+        el: number;
+        rng: number;
+        parallacticAngle: number;
+    };
+    private static moonCycles;
+    /**
+     * calculations for illumination parameters of the moon,
+     * based on http://idlastro.gsfc.nasa.gov/ftp/pro/astro/mphase.pro formulas and
+     * Chapter 48 of "Astronomical Algorithms" 2nd edition by Jean Meeus (Willmann-Bell, Richmond) 1998.
+     * @param {number | Date} date Date object or timestamp for calculating moon-illumination
+     * @return {MoonIlluminationData} result object of moon-illumination
+     */
+    static getMoonIllumination(date: number | Date): MoonIlluminationData;
+    /**
+     * calculations for moon rise/set times are based on http://www.stargazing.net/kepler/moonrise.html article
+     * @param {number|Date} dateValue Date object or timestamp for calculating moon-times
+     * @param {number} lat latitude for calculating moon-times
+     * @param {number} lon longitude for calculating moon-times
+     * @param {boolean} [isUtc] defines if the calculation should be in utc or local time (default is local)
+     * @return {IMoonTimes} result object of sunTime
+     */
+    static getMoonTimes(dateValue: Date, lat: Radians, lon: Radians, isUtc?: boolean): {
+        rise: any;
+        set: any;
+        ye: any;
+        alwaysUp: any;
+        alwaysDown: any;
+        highest: any;
+    };
+    private static calculateRiseSetTimes;
+}
+export {};