ootk 1.0.7 → 1.5.0

package/lib/utils/moon-math.js

@@ -0,0 +1,387 @@
+/**
+ * @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 { DEG2RAD } from './constants';
+import { MS_PER_DAY } from '../utils/constants';
+import { SunMath } from './sun-math';
+var MoonMath = /** @class */ (function () {
+    function MoonMath() {
+    }
+    MoonMath.moonCoords = function (d) {
+        // geocentric ecliptic coordinates of the moon
+        var L = DEG2RAD * (218.316 + 13.176396 * d); // ecliptic longitude
+        var M = DEG2RAD * (134.963 + 13.064993 * d); // mean anomaly
+        var F = DEG2RAD * (93.272 + 13.22935 * d); // mean distance
+        var l = L + DEG2RAD * 6.289 * Math.sin(M); // longitude
+        var b = DEG2RAD * 5.128 * Math.sin(F); // latitude
+        var dt = 385001 - 20905 * Math.cos(M); // distance to the moon in km
+        return {
+            ra: SunMath.rightAscension(l, b),
+            dec: SunMath.declination(l, b),
+            dist: dt,
+        };
+    };
+    MoonMath.hoursLater = function (date, h) {
+        return new Date(date.getTime() + (h * MS_PER_DAY) / 24);
+    };
+    MoonMath.getMoonPosition = function (date, lat, lon) {
+        var lw = DEG2RAD * -lon;
+        var phi = DEG2RAD * lat;
+        var d = SunMath.date2jSince2000(date);
+        var c = MoonMath.moonCoords(d);
+        var H = SunMath.siderealTime(d, lw) - c.ra;
+        var h = SunMath.elevation(H, phi, c.dec);
+        // formula 14.1 of "Astronomical Algorithms" 2nd edition by Jean Meeus (Willmann-Bell, Richmond) 1998.
+        var pa = Math.atan2(Math.sin(H), Math.tan(phi) * Math.cos(c.dec) - Math.sin(c.dec) * Math.cos(H));
+        h += SunMath.astroRefraction(h); // altitude correction for refraction
+        return {
+            az: SunMath.azimuth(H, phi, c.dec),
+            el: h,
+            rng: c.dist,
+            parallacticAngle: pa,
+        };
+    };
+    /**
+     * 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
+     */
+    // eslint-disable-next-line max-statements
+    MoonMath.getMoonIllumination = function (date) {
+        var dateValue = date instanceof Date ? date.getTime() : date;
+        var lunarDaysMs = 2551442778; // The duration in days of a lunar cycle is 29.53058770576 days.
+        var firstNewMoon2000 = 947178840000; // first newMoon in the year 2000 2000-01-06 18:14
+        var d = SunMath.date2jSince2000(new Date(dateValue));
+        var s = SunMath.getSunRaDec(d);
+        var m = MoonMath.moonCoords(d);
+        var sdist = 149598000; // distance from Earth to Sun in km
+        var phi = Math.acos(Math.sin(s.dec) * Math.sin(m.dec) + Math.cos(s.dec) * Math.cos(m.dec) * Math.cos(s.ra - m.ra));
+        var inc = Math.atan2(sdist * Math.sin(phi), m.dist - sdist * Math.cos(phi));
+        var angle = Math.atan2(Math.cos(s.dec) * Math.sin(s.ra - m.ra), Math.sin(s.dec) * Math.cos(m.dec) - Math.cos(s.dec) * Math.sin(m.dec) * Math.cos(s.ra - m.ra));
+        var phaseValue = 0.5 + (0.5 * inc * (angle < 0 ? -1 : 1)) / Math.PI;
+        // calculates the difference in ms between the sirst fullMoon 2000 and given Date
+        var diffBase = dateValue - firstNewMoon2000;
+        // Calculate modulus to drop completed cycles
+        var cycleModMs = diffBase % lunarDaysMs;
+        // If negative number (date before new moon 2000) add lunarDaysMs
+        if (cycleModMs < 0) {
+            cycleModMs += lunarDaysMs;
+        }
+        var nextNewMoon = lunarDaysMs - cycleModMs + dateValue;
+        var nextFullMoon = lunarDaysMs / 2 - cycleModMs + dateValue;
+        if (nextFullMoon < dateValue) {
+            nextFullMoon += lunarDaysMs;
+        }
+        var quater = lunarDaysMs / 4;
+        var nextFirstQuarter = quater - cycleModMs + dateValue;
+        if (nextFirstQuarter < dateValue) {
+            nextFirstQuarter += lunarDaysMs;
+        }
+        var nextThirdQuarter = lunarDaysMs - quater - cycleModMs + dateValue;
+        if (nextThirdQuarter < dateValue) {
+            nextThirdQuarter += lunarDaysMs;
+        }
+        /*
+         * Calculate the fraction of the moon cycle
+         * const currentfrac = cycleModMs / lunarDaysMs;
+         */
+        var next = Math.min(nextNewMoon, nextFirstQuarter, nextFullMoon, nextThirdQuarter);
+        // eslint-disable-next-line init-declarations
+        var phase;
+        for (var index = 0; index < MoonMath.moonCycles.length; index++) {
+            var element = MoonMath.moonCycles[index];
+            if (phaseValue >= element.from && phaseValue <= element.to) {
+                phase = element;
+                break;
+            }
+        }
+        var type = '';
+        if (next === nextNewMoon) {
+            type = 'newMoon';
+        }
+        else if (next === nextFirstQuarter) {
+            type = 'firstQuarter';
+        }
+        else if (next === nextFullMoon) {
+            type = 'fullMoon';
+        }
+        else {
+            type = 'thirdQuarter';
+        }
+        return {
+            fraction: (1 + Math.cos(inc)) / 2,
+            phase: phase,
+            phaseValue: phaseValue,
+            angle: angle,
+            next: {
+                value: next,
+                date: new Date(next).toISOString(),
+                type: type,
+                newMoon: {
+                    value: nextNewMoon,
+                    date: new Date(nextNewMoon).toISOString(),
+                },
+                fullMoon: {
+                    value: nextFullMoon,
+                    date: new Date(nextFullMoon).toISOString(),
+                },
+                firstQuarter: {
+                    value: nextFirstQuarter,
+                    date: new Date(nextFirstQuarter).toISOString(),
+                },
+                thirdQuarter: {
+                    value: nextThirdQuarter,
+                    date: new Date(nextThirdQuarter).toISOString(),
+                },
+            },
+        };
+    };
+    /**
+     * 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
+     */
+    MoonMath.getMoonTimes = function (dateValue, lat, lon, isUtc) {
+        if (isUtc === void 0) { isUtc = false; }
+        var t = new Date(dateValue);
+        if (isUtc) {
+            t.setUTCHours(0, 0, 0, 0);
+        }
+        else {
+            t.setHours(0, 0, 0, 0);
+        }
+        var _a = MoonMath.calculateRiseSetTimes(t, lat, lon), rise = _a.rise, set = _a.set, ye = _a.ye;
+        var result = {
+            rise: null,
+            set: null,
+            ye: null,
+            alwaysUp: null,
+            alwaysDown: null,
+            highest: null,
+        };
+        if (rise) {
+            result.rise = new Date(MoonMath.hoursLater(dateValue, rise));
+        }
+        else {
+            result.rise = NaN;
+        }
+        if (set) {
+            result.set = new Date(MoonMath.hoursLater(dateValue, set));
+        }
+        else {
+            result.set = NaN;
+        }
+        if (!rise && !set) {
+            if (ye > 0) {
+                result.alwaysUp = true;
+                result.alwaysDown = false;
+            }
+            else {
+                result.alwaysUp = false;
+                result.alwaysDown = true;
+            }
+        }
+        else if (rise && set) {
+            result.alwaysUp = false;
+            result.alwaysDown = false;
+            result.highest = new Date(MoonMath.hoursLater(dateValue, Math.min(rise, set) + Math.abs(set - rise) / 2));
+        }
+        else {
+            result.alwaysUp = false;
+            result.alwaysDown = false;
+        }
+        return result;
+    };
+    // eslint-disable-next-line max-statements
+    MoonMath.calculateRiseSetTimes = function (t, lat, lon) {
+        var hc = 0.133 * DEG2RAD;
+        var h0 = MoonMath.getMoonPosition(t, lat, lon).el - hc;
+        var h1 = 0;
+        var h2 = 0;
+        var rise = 0;
+        var set = 0;
+        var a = 0;
+        var b = 0;
+        var xe = 0;
+        var ye = 0;
+        var d = 0;
+        var roots = 0;
+        var x1 = 0;
+        var x2 = 0;
+        var dx = 0;
+        // go in 2-hour chunks, each time seeing if a 3-point quadratic curve crosses zero (which means rise or set)
+        for (var i = 1; i <= 24; i += 2) {
+            h1 = MoonMath.getMoonPosition(MoonMath.hoursLater(t, i), lat, lon).el - hc;
+            h2 = MoonMath.getMoonPosition(MoonMath.hoursLater(t, i + 1), lat, lon).el - hc;
+            a = (h0 + h2) / 2 - h1;
+            b = (h2 - h0) / 2;
+            xe = -b / (2 * a);
+            ye = (a * xe + b) * xe + h1;
+            d = b * b - 4 * a * h1;
+            roots = 0;
+            if (d >= 0) {
+                dx = Math.sqrt(d) / (Math.abs(a) * 2);
+                x1 = xe - dx;
+                x2 = xe + dx;
+                if (Math.abs(x1) <= 1) {
+                    roots++;
+                }
+                if (Math.abs(x2) <= 1) {
+                    roots++;
+                }
+                if (x1 < -1) {
+                    x1 = x2;
+                }
+            }
+            if (roots === 1) {
+                if (h0 < 0) {
+                    rise = i + x1;
+                }
+                else {
+                    set = i + x1;
+                }
+            }
+            else if (roots === 2) {
+                rise = i + (ye < 0 ? x2 : x1);
+                set = i + (ye < 0 ? x1 : x2);
+            }
+            if (rise && set) {
+                break;
+            }
+            h0 = h2;
+        }
+        return { rise: rise, set: set, ye: ye };
+    };
+    MoonMath.moonCycles = [
+        {
+            from: 0,
+            to: 0.033863193308711,
+            id: 'newMoon',
+            emoji: '🌚',
+            code: ':new_moon_with_face:',
+            name: 'New Moon',
+            weight: 1,
+            css: 'wi-moon-new',
+        },
+        {
+            from: 0.033863193308711,
+            to: 0.216136806691289,
+            id: 'waxingCrescentMoon',
+            emoji: '🌒',
+            code: ':waxing_crescent_moon:',
+            name: 'Waxing Crescent',
+            weight: 6.3825,
+            css: 'wi-moon-wax-cres',
+        },
+        {
+            from: 0.216136806691289,
+            to: 0.283863193308711,
+            id: 'firstQuarterMoon',
+            emoji: '🌓',
+            code: ':first_quarter_moon:',
+            name: 'First Quarter',
+            weight: 1,
+            css: 'wi-moon-first-quart',
+        },
+        {
+            from: 0.283863193308711,
+            to: 0.466136806691289,
+            id: 'waxingGibbousMoon',
+            emoji: '🌔',
+            code: ':waxing_gibbous_moon:',
+            name: 'Waxing Gibbous',
+            weight: 6.3825,
+            css: 'wi-moon-wax-gibb',
+        },
+        {
+            from: 0.466136806691289,
+            to: 0.533863193308711,
+            id: 'fullMoon',
+            emoji: '🌝',
+            code: ':full_moon_with_face:',
+            name: 'Full Moon',
+            weight: 1,
+            css: 'wi-moon-full',
+        },
+        {
+            from: 0.533863193308711,
+            to: 0.716136806691289,
+            id: 'waningGibbousMoon',
+            emoji: '🌖',
+            code: ':waning_gibbous_moon:',
+            name: 'Waning Gibbous',
+            weight: 6.3825,
+            css: 'wi-moon-wan-gibb',
+        },
+        {
+            from: 0.716136806691289,
+            to: 0.783863193308711,
+            id: 'thirdQuarterMoon',
+            emoji: '🌗',
+            code: ':last_quarter_moon:',
+            name: 'third Quarter',
+            weight: 1,
+            css: 'wi-moon-third-quart',
+        },
+        {
+            from: 0.783863193308711,
+            to: 0.966136806691289,
+            id: 'waningCrescentMoon',
+            emoji: '🌘',
+            code: ':waning_crescent_moon:',
+            name: 'Waning Crescent',
+            weight: 6.3825,
+            css: 'wi-moon-wan-cres',
+        },
+        {
+            from: 0.966136806691289,
+            to: 1,
+            id: 'newMoon',
+            emoji: '🌚',
+            code: ':new_moon_with_face:',
+            name: 'New Moon',
+            weight: 1,
+            css: 'wi-moon-new',
+        },
+    ];
+    return MoonMath;
+}());
+export { MoonMath };
+//# sourceMappingURL=moon-math.js.map

package/lib/utils/moon-math.js.map

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

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

@@ -0,0 +1,230 @@
+/**
+ * @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-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
+ *
+ * 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/>.
+ */
+import { AzEl, Meters, SunTime } from '../types/types';
+import { Degrees, Radians } from '../ootk';
+export declare class SunMath {
+    private static readonly J1970;
+    private static readonly J2000;
+    private static readonly J0;
+    private static readonly e;
+    private static times;
+    private static julianCycle;
+    /**
+     * calculates the obderver angle
+     * @param {number} alt  the observer altitude (in meters) relative to the horizon
+     * @returns {number} height for further calculations
+     */
+    private static observerAngle;
+    /**
+     * get solar mean anomaly
+     * @param {number} d - julian day
+     * @returns {number} solar mean anomaly
+     */
+    private static solarMeanAnomaly;
+    /**
+     * convert Julian calendar to date object
+     * @param {number} julian day number in Julian calendar to convert
+     * @return {number} result date as timestamp
+     */
+    static julian2date(julian: number): Date;
+    /**
+     * get number of days for a dateValue since 2000
+     *
+     * See: https://en.wikipedia.org/wiki/Epoch_(astronomy)
+     *
+     * @param {number} date date as timestamp to get days
+     * @return {number} count of days
+     */
+    static date2jSince2000(date: Date): number;
+    /**
+     * get right ascension
+     * @param {number} l - ecliptic longitude
+     * @param {number} b - ecliptic latitude
+     * @returns {number} right ascension
+     */
+    static rightAscension(l: number, b: number): Radians;
+    /**
+     * get declination
+     * @param {number} l - ecliptic longitude
+     * @param {number} b - ecliptic latitude
+     * @returns {number} declination
+     */
+    static declination(l: number, b: number): Radians;
+    /**
+     * get azimuth
+     * @param {number} H - siderealTime
+     * @param {Radians} phi - latitude
+     * @param {Radians} dec - The declination of the sun
+     * @returns {Radians} azimuth in rad
+     */
+    static azimuth(H: number, phi: Radians, dec: Radians): Radians;
+    /**
+     * get elevation (sometimes called altitude)
+     * @param {number} H - siderealTime
+     * @param {Radians} phi - latitude
+     * @param {Radians} dec - The declination of the sun
+     * @returns {Radians} elevation
+     */
+    static elevation(H: number, phi: Radians, dec: Radians): Radians;
+    /**
+     * side real time
+     * @param {number} d - julian day
+     * @param {Radians} lw - longitude of the observer
+     * @returns {number} sidereal time
+     */
+    static siderealTime(d: number, lw: Radians): number;
+    /**
+     * get astro refraction
+     * @param {Radians} h - elevation
+     * @returns {number} refraction
+     */
+    static astroRefraction(h: Degrees): Radians;
+    /**
+     * ecliptic longitude
+     * @param {number} M - solar mean anomaly
+     * @returns {number} ecliptic longitude
+     */
+    static eclipticLongitude(M: number): number;
+    /**
+     * ecliptic latitude
+     * @param {number} B - ?
+     * @returns {number} ecliptic latitude
+     */
+    static eclipticLatitude(B: number): number;
+    /**
+     * Julian cycle
+     * @param {number} d - number of days
+     * @param {number} lw - rad * -lng;
+     * @returns {number} julian cycle
+     */
+    static julianCyle(d: number, lw: number): number;
+    /**
+     * approx transit
+     * @param {number} Ht - hourAngle
+     * @param {number} lw - rad * -lng
+     * @param {number} n - Julian cycle
+     * @returns {number} approx transit
+     */
+    static approxTransit(Ht: number, lw: number, n: number): number;
+    /**
+     * solar transit in Julian
+     * @param {number} ds - approxTransit
+     * @param {number} M - solar mean anomal
+     * @param {number} L - ecliptic longitude
+     * @returns {number} solar transit in Julian
+     */
+    static solarTransitJulian(ds: number, M: number, L: number): number;
+    /**
+     * hour angle
+     * @param {number} h - heigh at 0
+     * @param {number} phi -  rad * lat;
+     * @param {number} dec - declination
+     * @returns {number} hour angle
+     */
+    static hourAngle(h: number, phi: number, dec: number): number;
+    /**
+     * returns set time for the given sun altitude
+     * @param {number} h - heigh at 0
+     * @param {number} lw - rad * -lng
+     * @param {number} phi -  rad * lat;
+     * @param {number} dec - declination
+     * @param {number} n - Julian cycle
+     * @param {number} M - solar mean anomal
+     * @param {number} L - ecliptic longitude
+     * @returns {number} set time
+     */
+    static getSetJulian(h: number, lw: number, phi: number, dec: number, n: number, M: number, L: number): number;
+    /**
+     * returns set time for the given sun altitude
+     * @param {Meters} alt - altitude at 0
+     * @param {Radians} lw - -lng
+     * @param {Radians} phi - lat;
+     * @param {Radians} dec - declination
+     * @param {number} n - Julian cycle
+     * @param {number} M - solar mean anomal
+     * @param {number} L - ecliptic longitude
+     * @return {J2000Value} sunset time in days since 2000
+     */
+    private static getSetJ;
+    /**
+     * calculates sun times for a given date and latitude/longitude
+     * @param {Date|number} dateVal Date object for calculating sun-times
+     * @param {number} lat latitude for calculating sun-times
+     * @param {number} lon longitude for calculating sun-times
+     * @param {number} [alt=0]  the observer height (in meters) relative to the horizon
+     * @param {boolean} [isUtc=false] defines if the calculation should be in utc or local time (default is local)
+     * @return {SunTime} result object of sunTime
+     */
+    static getTimes(dateVal: Date, lat: Degrees, lon: Degrees, alt?: Meters, isUtc?: boolean): SunTime;
+    private static calculateJnoon;
+    /**
+     * calculates time for a given azimuth angle for a given date and latitude/longitude
+     * @param {number|Date} dateValue Date object or timestamp for calculating sun-time
+     * @param {Degrees} lat latitude for calculating sun-time
+     * @param {Degrees} lon longitude for calculating sun-time
+     * @param {Radians | Degrees} az azimuth for calculating sun-time
+     * @param {boolean} [isDegrees] true if the az angle is in degree and not in rad
+     * @return {Date} result time of sun-time
+     */
+    static getSunTimeByAzimuth(dateValue: any, lat: Degrees, lon: Degrees, az: Radians | Degrees, isDegrees?: boolean): Date;
+    /**
+     * get azimuth
+     * @param {number} H - siderealTime
+     * @param {Radians} phi - latitude
+     * @param {Radians} dec - The declination of the sun
+     * @returns {Radians} azimuth
+     */
+    private static getAzimuth;
+    /**
+     * Convert Date to Solar Date/Time
+     *
+     * Based on https://www.pveducation.org/pvcdrom/properties-of-sunlight/solar-time
+     *
+     * See: https://github.com/mourner/suncalc/pull/156
+     *
+     * @param {date} date - Date to calculate for
+     * @param {number} utcOffset - UTC offset in hours
+     * @param {Degrees} lon - Longitude in degrees
+     * @returns {Date} - Date Object in Solar Time
+     */
+    static getSolarTime(date: Date, utcOffset: number, lon: number): Date;
+    static getStarAzEl(date: Date, lat: Degrees, lon: Degrees, ra: number, dec: number): AzEl;
+    static getSunAzEl(date: Date, lat: Degrees, lon: Degrees): AzEl;
+    static getSunRaDec(d: number): {
+        dec: number;
+        ra: number;
+    };
+}