ootk 4.0.8 → 5.0.0

package/dist/coordinate/EquinoctialElements.js

@@ -0,0 +1,172 @@
+/**
+ * @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 { earthGravityParam, MINUTES_PER_DAY, TAU } from '../utils/constants.js';
+import { newtonM } from '../utils/functions.js';
+import { ClassicalElements } from './ClassicalElements.js';
+/**
+ * Equinoctial elements are a set of orbital elements used to describe the
+ * orbits of celestial bodies, such as satellites around a planet. They provide
+ * an alternative to the traditional Keplerian elements and are especially
+ * useful for avoiding singularities and numerical issues in certain types of
+ * orbits.
+ *
+ * Unlike Keplerian elements, equinoctial elements don't suffer from
+ * singularities at zero eccentricity (circular orbits) or zero inclination
+ * (equatorial orbits). This makes them more reliable for numerical simulations
+ * and analytical studies, especially in these edge cases.
+ * @see https://faculty.nps.edu/dad/orbital/th0.pdf
+ */
+export class EquinoctialElements {
+    epoch;
+    /** The semi-major axis of the orbit in kilometers. */
+    a;
+    /** The h component of the eccentricity vector. */
+    h;
+    /** The k component of the eccentricity vector. */
+    k;
+    /** The p component of the ascending node vector. */
+    p;
+    /** The q component of the ascending node vector. */
+    q;
+    /** The mean longitude of the orbit in radians. */
+    lambda;
+    /** The gravitational parameter of the central body in km³/s². */
+    mu;
+    /** The retrograde factor. 1 for prograde orbits, -1 for retrograde orbits. */
+    I;
+    constructor({ epoch, h, k, lambda, a, p, q, mu, I }) {
+        this.epoch = epoch;
+        this.h = h;
+        this.k = k;
+        this.lambda = lambda;
+        this.a = a;
+        this.p = p;
+        this.q = q;
+        this.mu = mu ?? earthGravityParam;
+        this.I = I ?? 1;
+    }
+    /**
+     * Returns a string representation of the EquinoctialElements object.
+     * @returns A string representation of the EquinoctialElements object.
+     */
+    toString() {
+        return [
+            '[EquinoctialElements]',
+            `  Epoch: ${this.epoch}`,
+            `  a: ${this.a} km`,
+            `  h: ${this.h}`,
+            `  k: ${this.k}`,
+            `  p: ${this.p}`,
+            `  q: ${this.q}`,
+            `  lambda: ${this.lambda} rad`,
+        ].join('\n');
+    }
+    /**
+     * Gets the semimajor axis.
+     * @returns The semimajor axis in kilometers.
+     */
+    get semimajorAxis() {
+        return this.a;
+    }
+    /**
+     * Gets the mean longitude.
+     * @returns The mean longitude in radians.
+     */
+    get meanLongitude() {
+        return this.lambda;
+    }
+    /**
+     * Calculates the mean motion of the celestial object.
+     * @returns The mean motion in units of radians per second.
+     */
+    get meanMotion() {
+        return Math.sqrt(this.mu / this.a ** 3);
+    }
+    /**
+     * Gets the retrograde factor.
+     * @returns The retrograde factor.
+     */
+    get retrogradeFactor() {
+        return this.I;
+    }
+    /**
+     * Checks if the orbit is prograde.
+     * @returns True if the orbit is prograde, false otherwise.
+     */
+    isPrograde() {
+        return this.I === 1;
+    }
+    /**
+     * Checks if the orbit is retrograde.
+     * @returns True if the orbit is retrograde, false otherwise.
+     */
+    isRetrograde() {
+        return this.I === -1;
+    }
+    /**
+     * Gets the period of the orbit.
+     * @returns The period in minutes.
+     */
+    get period() {
+        const periodSec = (TAU * Math.sqrt(this.semimajorAxis ** 3 / this.mu));
+        return (periodSec / 60);
+    }
+    /**
+     * Gets the number of revolutions per day.
+     * @returns The number of revolutions per day.
+     */
+    get revsPerDay() {
+        return MINUTES_PER_DAY / this.period;
+    }
+    /**
+     * Converts the equinoctial elements to classical elements.
+     * @returns The classical elements.
+     */
+    toClassicalElements() {
+        const a = this.semimajorAxis;
+        const e = Math.sqrt(this.k * this.k + this.h * this.h);
+        const i = Math.PI * ((1.0 - this.I) * 0.5) + 2.0 * this.I * Math.atan(Math.sqrt(this.p * this.p + this.q * this.q));
+        const o = Math.atan2(this.p, this.q);
+        const w = Math.atan2(this.h, this.k) - this.I * Math.atan2(this.p, this.q);
+        const m = this.lambda - this.I * o - w;
+        const v = newtonM(e, m).nu;
+        return new ClassicalElements({
+            epoch: this.epoch,
+            semimajorAxis: a,
+            eccentricity: e,
+            inclination: i,
+            rightAscension: o,
+            argPerigee: w,
+            trueAnomaly: v,
+            mu: this.mu,
+        });
+    }
+    /**
+     * Converts the equinoctial elements to position and velocity.
+     * @returns The position and velocity in classical elements.
+     */
+    toPositionVelocity() {
+        return this.toClassicalElements().toPositionVelocity();
+    }
+}
+//# sourceMappingURL=EquinoctialElements.js.map

package/dist/coordinate/EquinoctialElements.js.map

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

package/dist/coordinate/FormatTle.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @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 { StringifiedNumber, TleParams, TleLine1, TleLine2 } from '../main.js';
+/**
+ * A class containing static methods for formatting TLEs (Two-Line Elements).
+ */
+export declare abstract class FormatTle {
+    private constructor();
+    /**
+     * Creates a TLE (Two-Line Element) string based on the provided TleParams.
+     * @param tleParams - The parameters used to generate the TLE.
+     * @returns An object containing the TLE strings tle1 and tle2.
+     */
+    static createTle(tleParams: TleParams): {
+        tle1: TleLine1;
+        tle2: TleLine2;
+    };
+    /**
+     * Converts the argument of perigee to a stringified number.
+     * @param argPe - The argument of perigee to be converted. Can be either a number or a string.
+     * @returns The argument of perigee as a stringified number.
+     * @throws Error if the length of the argument of perigee is not 8.
+     */
+    static argumentOfPerigee(argPe: number | string): StringifiedNumber;
+    /**
+     * Returns the eccentricity value of a given string.
+     * @param ecen - The string representing the eccentricity.
+     * @returns The eccentricity value.
+     * @throws Error if the length of the eccentricity string is not 7.
+     */
+    static eccentricity(ecen: string): string;
+    /**
+     * Converts the inclination value to a string representation.
+     * @param inc - The inclination value to be converted.
+     * @returns The string representation of the inclination value.
+     * @throws Error if the length of the converted value is not 8.
+     */
+    static inclination(inc: number | string): StringifiedNumber;
+    /**
+     * Converts the mean anomaly to a string representation with 8 digits, padded with leading zeros.
+     * @param meana - The mean anomaly to be converted. Can be either a number or a string.
+     * @returns The mean anomaly as a string with 8 digits, padded with leading zeros.
+     * @throws Error if the length of the mean anomaly is not 8.
+     */
+    static meanAnomaly(meana: number | string): StringifiedNumber;
+    /**
+     * Converts the mean motion value to a string representation with 8 decimal
+     * places. If the input is a number, it is converted to a string. If the input
+     * is already a string, it is parsed as a float and then converted to a string
+     * with 8 decimal places. The resulting string is padded with leading zeros to
+     * ensure a length of 11 characters. Throws an error if the resulting string
+     * does not have a length of 11 characters.
+     * @param meanmo - The mean motion value to be converted.
+     * @returns The string representation of the mean motion value with 8 decimal
+     * places and padded with leading zeros.
+     * @throws Error if the resulting string does not have a length of 11
+     * characters.
+     */
+    static meanMotion(meanmo: number | string): StringifiedNumber;
+    /**
+     * Converts the right ascension value to a stringified number.
+     * @param rasc - The right ascension value to convert.
+     * @returns The stringified number representation of the right ascension.
+     * @throws Error if the length of the converted right ascension is not 8.
+     */
+    static rightAscension(rasc: number | string): StringifiedNumber;
+    /**
+     * Sets a character at a specific index in a string. If the index is out of range, the original string is returned.
+     * @param str - The input string.
+     * @param index - The index at which to set the character.
+     * @param chr - The character to set at the specified index.
+     * @returns The modified string with the character set at the specified index.
+     */
+    static setCharAt(str: string, index: number, chr: string): string;
+}

package/dist/coordinate/FormatTle.js

@@ -0,0 +1,184 @@
+/**
+ * @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 { Tle } from '../main.js';
+/**
+ * A class containing static methods for formatting TLEs (Two-Line Elements).
+ */
+export class FormatTle {
+    constructor() {
+        // Static class
+    }
+    /**
+     * Creates a TLE (Two-Line Element) string based on the provided TleParams.
+     * @param tleParams - The parameters used to generate the TLE.
+     * @returns An object containing the TLE strings tle1 and tle2.
+     */
+    static createTle(tleParams) {
+        const { inc, meanmo, rasc, argPe, meana, ecen, epochyr, epochday, intl } = tleParams;
+        const scc = Tle.convert6DigitToA5(tleParams.scc);
+        const epochYrStr = epochyr.padStart(2, '0');
+        const epochdayStr = parseFloat(epochday).toFixed(8).padStart(12, '0');
+        const incStr = FormatTle.inclination(inc);
+        const meanmoStr = FormatTle.meanMotion(meanmo);
+        const rascStr = FormatTle.rightAscension(rasc);
+        const argPeStr = FormatTle.argumentOfPerigee(argPe);
+        const meanaStr = FormatTle.meanAnomaly(meana);
+        const ecenStr = FormatTle.eccentricity(ecen);
+        const intlStr = intl.padEnd(8, ' ');
+        // M' and M'' are both set to 0 to put the object in a perfect stable orbit
+        let TLE1Ending = tleParams.sat ? tleParams.sat.tle1.substring(32, 71) : ' +.00000000 +00000+0 +00000-0 0  9990';
+        // Add explicit positive/negative signs
+        TLE1Ending = TLE1Ending[1] === ' ' ? FormatTle.setCharAt(TLE1Ending, 1, '+') : TLE1Ending;
+        TLE1Ending = TLE1Ending[12] === ' ' ? FormatTle.setCharAt(TLE1Ending, 12, '+') : TLE1Ending;
+        TLE1Ending = TLE1Ending[21] === ' ' ? FormatTle.setCharAt(TLE1Ending, 21, '+') : TLE1Ending;
+        TLE1Ending = TLE1Ending[32] === ' ' ? FormatTle.setCharAt(TLE1Ending, 32, '0') : TLE1Ending;
+        const tle1 = `1 ${scc}U ${intlStr} ${epochYrStr}${epochdayStr}${TLE1Ending}`;
+        const tle2 = `2 ${scc} ${incStr} ${rascStr} ${ecenStr} ${argPeStr} ${meanaStr} ${meanmoStr} 00010`;
+        return { tle1: tle1, tle2: tle2 };
+    }
+    /**
+     * Converts the argument of perigee to a stringified number.
+     * @param argPe - The argument of perigee to be converted. Can be either a number or a string.
+     * @returns The argument of perigee as a stringified number.
+     * @throws Error if the length of the argument of perigee is not 8.
+     */
+    static argumentOfPerigee(argPe) {
+        if (typeof argPe === 'number') {
+            argPe = argPe.toString();
+        }
+        const argPeNum = parseFloat(argPe).toFixed(4);
+        const argPe0 = argPeNum.padStart(8, '0');
+        if (argPe0.length !== 8) {
+            throw new Error('argPe length is not 8');
+        }
+        return argPe0;
+    }
+    /**
+     * Returns the eccentricity value of a given string.
+     * @param ecen - The string representing the eccentricity.
+     * @returns The eccentricity value.
+     * @throws Error if the length of the eccentricity string is not 7.
+     */
+    static eccentricity(ecen) {
+        let ecen0 = ecen.padEnd(9, '0');
+        if (ecen0[1] === '.') {
+            ecen0 = ecen0.substring(2);
+        }
+        else {
+            ecen0 = ecen0.substring(0, 7);
+        }
+        if (ecen0.length !== 7) {
+            throw new Error('ecen length is not 7');
+        }
+        return ecen0;
+    }
+    /**
+     * Converts the inclination value to a string representation.
+     * @param inc - The inclination value to be converted.
+     * @returns The string representation of the inclination value.
+     * @throws Error if the length of the converted value is not 8.
+     */
+    static inclination(inc) {
+        if (typeof inc === 'number') {
+            inc = inc.toString();
+        }
+        const incNum = parseFloat(inc).toFixed(4);
+        const inc0 = incNum.padStart(8, '0');
+        if (inc0.length !== 8) {
+            throw new Error('inc length is not 8');
+        }
+        return inc0;
+    }
+    /**
+     * Converts the mean anomaly to a string representation with 8 digits, padded with leading zeros.
+     * @param meana - The mean anomaly to be converted. Can be either a number or a string.
+     * @returns The mean anomaly as a string with 8 digits, padded with leading zeros.
+     * @throws Error if the length of the mean anomaly is not 8.
+     */
+    static meanAnomaly(meana) {
+        if (typeof meana === 'number') {
+            meana = meana.toString();
+        }
+        const meanaNum = parseFloat(meana).toFixed(4);
+        const meana0 = meanaNum.padStart(8, '0');
+        if (meana0.length !== 8) {
+            throw new Error('meana length is not 8');
+        }
+        return meana0;
+    }
+    /**
+     * Converts the mean motion value to a string representation with 8 decimal
+     * places. If the input is a number, it is converted to a string. If the input
+     * is already a string, it is parsed as a float and then converted to a string
+     * with 8 decimal places. The resulting string is padded with leading zeros to
+     * ensure a length of 11 characters. Throws an error if the resulting string
+     * does not have a length of 11 characters.
+     * @param meanmo - The mean motion value to be converted.
+     * @returns The string representation of the mean motion value with 8 decimal
+     * places and padded with leading zeros.
+     * @throws Error if the resulting string does not have a length of 11
+     * characters.
+     */
+    static meanMotion(meanmo) {
+        if (typeof meanmo === 'number') {
+            meanmo = meanmo.toString();
+        }
+        const meanmoNum = parseFloat(meanmo).toFixed(8);
+        const meanmo0 = meanmoNum.padStart(11, '0');
+        if (meanmo0.length !== 11) {
+            throw new Error('meanmo length is not 11');
+        }
+        return meanmo0;
+    }
+    /**
+     * Converts the right ascension value to a stringified number.
+     * @param rasc - The right ascension value to convert.
+     * @returns The stringified number representation of the right ascension.
+     * @throws Error if the length of the converted right ascension is not 8.
+     */
+    static rightAscension(rasc) {
+        if (typeof rasc === 'number') {
+            rasc = rasc.toString();
+        }
+        const rascNum = parseFloat(rasc).toFixed(4);
+        const rasc0 = rascNum.padStart(8, '0');
+        if (rasc0.length !== 8) {
+            throw new Error('rasc length is not 8');
+        }
+        return rasc0;
+    }
+    /**
+     * Sets a character at a specific index in a string. If the index is out of range, the original string is returned.
+     * @param str - The input string.
+     * @param index - The index at which to set the character.
+     * @param chr - The character to set at the specified index.
+     * @returns The modified string with the character set at the specified index.
+     */
+    static setCharAt(str, index, chr) {
+        if (index > str.length - 1) {
+            return str;
+        }
+        return `${str.substring(0, index)}${chr}${str.substring(index + 1)}`;
+    }
+}
+//# sourceMappingURL=FormatTle.js.map

package/dist/coordinate/FormatTle.js.map

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

package/dist/coordinate/Geodetic.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @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 { AngularDistanceMethod, Degrees, GroundObject, Kilometers, Radians } from '../main.js';
+import { EpochUTC } from '../time/EpochUTC.js';
+import { ITRF } from './ITRF.js';
+/**
+ * This Geodetic class represents a geodetic coordinate in three-dimensional
+ * space, consisting of latitude, longitude, and altitude. It provides various
+ * methods to perform calculations and operations related to geodetic
+ * coordinates.
+ *
+ * This is a class for geodetic coordinates. This is related to the GroundObject
+ * class, which is used to represent an object on the surface of the Earth.
+ */
+export declare class Geodetic {
+    lat: Radians;
+    lon: Radians;
+    alt: Kilometers;
+    constructor(latitude: Radians, longitude: Radians, altitude: Kilometers);
+    /**
+     * Creates a Geodetic object from latitude, longitude, and altitude values in
+     * degrees.
+     * @param latitude The latitude value in degrees.
+     * @param longitude The longitude value in degrees.
+     * @param altitude The altitude value in kilometers.
+     * @returns A Geodetic object representing the specified latitude, longitude,
+     * and altitude.
+     */
+    static fromDegrees(latitude: Degrees, longitude: Degrees, altitude: Kilometers): Geodetic;
+    /**
+     * Returns a string representation of the Geodetic object.
+     * @returns A string containing the latitude, longitude, and altitude of the Geodetic object.
+     */
+    toString(): string;
+    /**
+     * Gets the latitude in degrees.
+     * @returns The latitude in degrees.
+     */
+    get latDeg(): number;
+    /**
+     * Gets the longitude in degrees.
+     * @returns The longitude in degrees.
+     */
+    get lonDeg(): number;
+    /**
+     * Converts the geodetic coordinates to a ground position.
+     * @returns The ground position object.
+     */
+    toGroundObject(): GroundObject;
+    /**
+     * Converts the geodetic coordinates to the International Terrestrial
+     * Reference Frame (ITRF) coordinates.
+     * @param epoch The epoch in UTC.
+     * @returns The ITRF coordinates.
+     */
+    toITRF(epoch: EpochUTC): ITRF;
+    /**
+     * Calculates the angle between two geodetic coordinates.
+     * @param g The geodetic coordinate to calculate the angle to.
+     * @param method The method to use for calculating the angular distance (optional, default is Haversine).
+     * @returns The angle between the two geodetic coordinates in radians.
+     */
+    angle(g: Geodetic, method?: AngularDistanceMethod): Radians;
+    /**
+     * Calculates the angle in degrees between two Geodetic coordinates.
+     * @param g The Geodetic coordinate to calculate the angle with.
+     * @param method The method to use for calculating the angular distance (optional, default is Haversine).
+     * @returns The angle in degrees.
+     */
+    angleDeg(g: Geodetic, method?: AngularDistanceMethod): Degrees;
+    /**
+     * Calculates the distance between two geodetic coordinates.
+     * @param g The geodetic coordinates to calculate the distance to.
+     * @param method The method to use for calculating the angular distance. Default is Haversine.
+     * @returns The distance between the two geodetic coordinates in kilometers.
+     */
+    distance(g: Geodetic, method?: AngularDistanceMethod): Kilometers;
+    /**
+     * Calculates the field of view based on the altitude of the Geodetic object.
+     * @returns The field of view in radians.
+     */
+    fieldOfView(): Radians;
+    /**
+     * Determines if the current geodetic coordinate can see another geodetic coordinate.
+     * @param g The geodetic coordinate to check for visibility.
+     * @param method The method to use for calculating the angular distance (optional, default is Haversine).
+     * @returns A boolean indicating if the current coordinate can see the other coordinate.
+     */
+    isInView(g: Geodetic, method?: AngularDistanceMethod): boolean;
+}