@saber-usa/node-common 1.7.7 → 1.7.9-alpha.1

package/src/LLA.js

@@ -1,179 +1,179 @@
-/**
- * Latitude, longitude, and altitude which define a ground point.
- *
- * Latitude must be between ±90°, longitude must be between ±180°.
- * Latitude is typically denoted as 90° N to 90° S (±90°).
- * Longitude is typically denoted as 180° E to 180° W (±180°).
- */
-
-class LLA {
-    /**
-     * Create an LLA object from degrees
-     * @param {number} latitudeDeg - Latitude in degrees (±90°)
-     * @param {number} longitudeDeg - Longitude in degrees (±180°)
-     * @param {number} altitudeKm - Altitude in kilometers (default: 0)
-     */
-    constructor(latitudeDeg, longitudeDeg, altitudeKm = 0) {
-        // If first parameter is an Angle object, use alternate constructor pattern
-        if (
-            latitudeDeg instanceof Angle || (latitudeDeg
-                && typeof latitudeDeg === "object"
-                && Object.prototype.hasOwnProperty.call(latitudeDeg, "Degrees"))
-        ) {
-            this._initFromAngles(latitudeDeg, longitudeDeg, altitudeKm);
-        } else {
-            this._initFromDegrees(latitudeDeg, longitudeDeg, altitudeKm);
-        }
-    }
-
-    /**
-     * Create from degree values
-     * @private
-     * @param {number} latitudeDeg - Latitude in degrees
-     * @param {number} longitudeDeg - Longitude in degrees
-     * @param {number} altitudeKm - Altitude in kilometers
-     */
-    _initFromDegrees(latitudeDeg, longitudeDeg, altitudeKm) {
-        this.Latitude = new Angle(latitudeDeg);
-        this.Longitude = new Angle(longitudeDeg);
-        this.AltitudeKm = altitudeKm;
-
-        // Apply wrapping constraints
-        this._applyConstraints();
-    }
-
-    /**
-     * Create from Angle objects
-     * @private
-     * @param {Angle} latitude - Latitude Angle object
-     * @param {Angle} longitude - Longitude Angle object
-     * @param {number} altitudeKm - Altitude in kilometers
-     */
-    _initFromAngles(latitude, longitude, altitudeKm) {
-        this.Latitude = latitude;
-        this.Longitude = longitude;
-        this.AltitudeKm = altitudeKm;
-
-        // Apply wrapping constraints
-        this._applyConstraints();
-    }
-
-    /**
-     * Apply latitude/longitude constraints
-     * @private
-     */
-    _applyConstraints() {
-        // Wrap latitude to ±90° (quarter revolution)
-        if (this.Latitude.Degrees > 90) {
-            this.Latitude = new Angle(180 - this.Latitude.Degrees);
-        } else if (this.Latitude.Degrees < -90) {
-            this.Latitude = new Angle(-180 - this.Latitude.Degrees);
-        }
-
-        // Wrap longitude to ±180° (half revolution)
-        let lon = this.Longitude.Degrees;
-        while (lon > 180) lon -= 360;
-        while (lon < -180) lon += 360;
-        this.Longitude = new Angle(lon);
-    }
-
-    /**
-     * φ : Geodetic latitude, between ±90°.
-     * @return {Angle} Latitude angle
-     */
-    get latitude() {
-        return this.Latitude;
-    }
-
-    /**
-     * λ : Geodetic longitude, between ±180°.
-     * @return {Angle} Longitude angle
-     */
-    get longitude() {
-        return this.Longitude;
-    }
-
-    /**
-     * Altitude in kilometers.
-     * @return {number} Altitude in km
-     */
-    get altitudeKm() {
-        return this.AltitudeKm;
-    }
-
-
-    /**
-     * Create LLA from JSON object
-     * @param {Object} json - JSON object with latitude, longitude, altitude_km properties
-     * @return {LLA} New LLA instance
-     */
-    static fromJSON(json) {
-        return new LLA(json.latitude, json.longitude, json.altitude_km || 0);
-    }
-
-    /**
-     * Convert to JSON object
-     * @return {Object} JSON representation
-     */
-    toJSON() {
-        return {
-            latitude: this.Latitude.Degrees,
-            longitude: this.Longitude.Degrees,
-            altitude_km: this.AltitudeKm,
-        };
-    }
-
-    /**
-     * String representation
-     * @return {string} String representation of LLA
-     */
-    toString() {
-        return `LLA(${this.Latitude.Degrees.toFixed(6)}°, ${this.Longitude.Degrees.toFixed(6)}°, ${this.AltitudeKm.toFixed(3)} km)`;
-    }
-
-    /**
-     * Create a copy of this LLA
-     * @return {LLA} Copy of this LLA
-     */
-    clone() {
-        return new LLA(this.Latitude.Degrees, this.Longitude.Degrees, this.AltitudeKm);
-    }
-
-    /**
-     * Check equality with another LLA (within tolerance)
-     * @param {LLA} other - Other LLA to compare
-     * @param {number} tolerance - Tolerance for comparison (default: 1e-9)
-     * @return {boolean} True if equal within tolerance
-     */
-    equals(other, tolerance = 1e-9) {
-        return Math.abs(this.Latitude.Degrees - other.Latitude.Degrees) < tolerance
-               && Math.abs(this.Longitude.Degrees - other.Longitude.Degrees) < tolerance
-               && Math.abs(this.AltitudeKm - other.AltitudeKm) < tolerance;
-    }
-}
-
-// Simple Angle class (you may already have this)
-class Angle {
-    constructor(degrees) {
-        this._degrees = degrees;
-    }
-
-    get Degrees() {
-        return this._degrees;
-    }
-
-    get Radians() {
-        return this._degrees * Math.PI / 180;
-    }
-
-    static FromDegrees(degrees) {
-        return new Angle(degrees);
-    }
-
-    static FromRadians(radians) {
-        return new Angle(radians * 180 / Math.PI);
-    }
-}
-
-// Export for use
-export {LLA, Angle};
+/**
+ * Latitude, longitude, and altitude which define a ground point.
+ *
+ * Latitude must be between ±90°, longitude must be between ±180°.
+ * Latitude is typically denoted as 90° N to 90° S (±90°).
+ * Longitude is typically denoted as 180° E to 180° W (±180°).
+ */
+
+class LLA {
+    /**
+     * Create an LLA object from degrees
+     * @param {number} latitudeDeg - Latitude in degrees (±90°)
+     * @param {number} longitudeDeg - Longitude in degrees (±180°)
+     * @param {number} altitudeKm - Altitude in kilometers (default: 0)
+     */
+    constructor(latitudeDeg, longitudeDeg, altitudeKm = 0) {
+        // If first parameter is an Angle object, use alternate constructor pattern
+        if (
+            latitudeDeg instanceof Angle || (latitudeDeg
+                && typeof latitudeDeg === "object"
+                && Object.prototype.hasOwnProperty.call(latitudeDeg, "Degrees"))
+        ) {
+            this._initFromAngles(latitudeDeg, longitudeDeg, altitudeKm);
+        } else {
+            this._initFromDegrees(latitudeDeg, longitudeDeg, altitudeKm);
+        }
+    }
+
+    /**
+     * Create from degree values
+     * @private
+     * @param {number} latitudeDeg - Latitude in degrees
+     * @param {number} longitudeDeg - Longitude in degrees
+     * @param {number} altitudeKm - Altitude in kilometers
+     */
+    _initFromDegrees(latitudeDeg, longitudeDeg, altitudeKm) {
+        this.Latitude = new Angle(latitudeDeg);
+        this.Longitude = new Angle(longitudeDeg);
+        this.AltitudeKm = altitudeKm;
+
+        // Apply wrapping constraints
+        this._applyConstraints();
+    }
+
+    /**
+     * Create from Angle objects
+     * @private
+     * @param {Angle} latitude - Latitude Angle object
+     * @param {Angle} longitude - Longitude Angle object
+     * @param {number} altitudeKm - Altitude in kilometers
+     */
+    _initFromAngles(latitude, longitude, altitudeKm) {
+        this.Latitude = latitude;
+        this.Longitude = longitude;
+        this.AltitudeKm = altitudeKm;
+
+        // Apply wrapping constraints
+        this._applyConstraints();
+    }
+
+    /**
+     * Apply latitude/longitude constraints
+     * @private
+     */
+    _applyConstraints() {
+        // Wrap latitude to ±90° (quarter revolution)
+        if (this.Latitude.Degrees > 90) {
+            this.Latitude = new Angle(180 - this.Latitude.Degrees);
+        } else if (this.Latitude.Degrees < -90) {
+            this.Latitude = new Angle(-180 - this.Latitude.Degrees);
+        }
+
+        // Wrap longitude to ±180° (half revolution)
+        let lon = this.Longitude.Degrees;
+        while (lon > 180) lon -= 360;
+        while (lon < -180) lon += 360;
+        this.Longitude = new Angle(lon);
+    }
+
+    /**
+     * φ : Geodetic latitude, between ±90°.
+     * @return {Angle} Latitude angle
+     */
+    get latitude() {
+        return this.Latitude;
+    }
+
+    /**
+     * λ : Geodetic longitude, between ±180°.
+     * @return {Angle} Longitude angle
+     */
+    get longitude() {
+        return this.Longitude;
+    }
+
+    /**
+     * Altitude in kilometers.
+     * @return {number} Altitude in km
+     */
+    get altitudeKm() {
+        return this.AltitudeKm;
+    }
+
+
+    /**
+     * Create LLA from JSON object
+     * @param {Object} json - JSON object with latitude, longitude, altitude_km properties
+     * @return {LLA} New LLA instance
+     */
+    static fromJSON(json) {
+        return new LLA(json.latitude, json.longitude, json.altitude_km || 0);
+    }
+
+    /**
+     * Convert to JSON object
+     * @return {Object} JSON representation
+     */
+    toJSON() {
+        return {
+            latitude: this.Latitude.Degrees,
+            longitude: this.Longitude.Degrees,
+            altitude_km: this.AltitudeKm,
+        };
+    }
+
+    /**
+     * String representation
+     * @return {string} String representation of LLA
+     */
+    toString() {
+        return `LLA(${this.Latitude.Degrees.toFixed(6)}°, ${this.Longitude.Degrees.toFixed(6)}°, ${this.AltitudeKm.toFixed(3)} km)`;
+    }
+
+    /**
+     * Create a copy of this LLA
+     * @return {LLA} Copy of this LLA
+     */
+    clone() {
+        return new LLA(this.Latitude.Degrees, this.Longitude.Degrees, this.AltitudeKm);
+    }
+
+    /**
+     * Check equality with another LLA (within tolerance)
+     * @param {LLA} other - Other LLA to compare
+     * @param {number} tolerance - Tolerance for comparison (default: 1e-9)
+     * @return {boolean} True if equal within tolerance
+     */
+    equals(other, tolerance = 1e-9) {
+        return Math.abs(this.Latitude.Degrees - other.Latitude.Degrees) < tolerance
+               && Math.abs(this.Longitude.Degrees - other.Longitude.Degrees) < tolerance
+               && Math.abs(this.AltitudeKm - other.AltitudeKm) < tolerance;
+    }
+}
+
+// Simple Angle class (you may already have this)
+class Angle {
+    constructor(degrees) {
+        this._degrees = degrees;
+    }
+
+    get Degrees() {
+        return this._degrees;
+    }
+
+    get Radians() {
+        return this._degrees * Math.PI / 180;
+    }
+
+    static FromDegrees(degrees) {
+        return new Angle(degrees);
+    }
+
+    static FromRadians(radians) {
+        return new Angle(radians * 180 / Math.PI);
+    }
+}
+
+// Export for use
+export {LLA, Angle};