@fboes/aerofly-custom-missions 1.12.0 → 1.13.0

package/CHANGELOG.md

@@ -2,7 +2,12 @@
 
 This changelog documents all notable changes to the Aerofly Custom Missions project. Each version entry includes a list of changes, with the most recent version at the top.
 
-## [1.12.0] - 2026-07-08
+## [1.13.0] - 2026-07-23
+
+- Made unit conversions more precise
+- Added correct UID generator
+
+## [1.12.0] - 2026-07-01
 
 - Added unofficial `_cruiseSpeed` property to `AeroflyNavigationConfig`
 

package/dist/dto-flight/AeroflyNavRouteAirports.js

@@ -1,5 +1,5 @@
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
-import { Convert } from "../node/Convert.js";
+import { convertFeetToMeter, convertMeterToFeet } from "../node/Convert.js";
 import { AeroflyNavRouteBase } from "./AeroflyNavRouteBase.js";
 class AeroflyNavRouteAirport extends AeroflyNavRouteBase {
     /**
@@ -27,10 +27,10 @@ class AeroflyNavRouteAirport extends AeroflyNavRouteBase {
      * @returns {number | null} elevation in feet, null if not set
      */
     get elevation_ft() {
-        return this.elevation !== null ? Convert.convertMeterToFeet(this.elevation) : null;
+        return this.elevation !== null ? convertMeterToFeet(this.elevation) : null;
     }
     set elevation_ft(elevation_ft) {
-        this.elevation = elevation_ft !== null ? Convert.convertFeetToMeter(elevation_ft) : null;
+        this.elevation = elevation_ft !== null ? convertFeetToMeter(elevation_ft) : null;
     }
     getElement(index = 0) {
         const element = super.getElement(index);

package/dist/dto-flight/AeroflyNavRouteBase.js

@@ -1,5 +1,5 @@
-import { Convert } from "../node/Convert.js";
-import { AeroflyConfigurationNode, AeroflyConfigurationNodeComment } from "../node/AeroflyConfigurationNode.js";
+import { convertLonLatToVector, convertVectorToLonLat } from "../node/Convert.js";
+import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
 export class AeroflyNavRouteBase {
     /**
      * @property {AeroflyNavRouteType} type like "origin", "departure_runway", "departure", "waypoint", "arrival", "approach", "destination_runway" or "destination"
@@ -18,7 +18,7 @@ export class AeroflyNavRouteBase {
      */
     latitude;
     /**
-     * @property {?bigint} uid unique identifier for the waypoint, must match Aerofly FS internal UID if used in an existing mission, can be null for new waypoints
+     * @property {?bigint} uid unique identifier for the waypoint, must match Aerofly FS internal UID if used in an existing mission. Obviously the UID encodes the geographic position as well as the name of the waypoint.
      */
     uid;
     /**
@@ -27,7 +27,7 @@ export class AeroflyNavRouteBase {
      * @param {number} longitude WGS84
      * @param {number} latitude WGS84
      * @param {object} [options] additional options for the waypoint
-     * @param {?bigint} [options.uid] unique identifier for the waypoint, must match Aerofly FS internal UID if used in an existing mission, can be null for new waypoints
+     * @param {?bigint} [options.uid] unique identifier for the waypoint, must match Aerofly FS internal UID if used in an existing mission. Obviously the UID encodes the geographic position as well as the name of the waypoint.
      */
     constructor(type, identifier, longitude, latitude, { uid = null } = {}) {
         this.type = type;
@@ -40,10 +40,10 @@ export class AeroflyNavRouteBase {
      * @returns {AeroflyVector3Float} to use in Aerofly FS4's `main.mcf`
      */
     get position() {
-        return Convert.convertLonLatToVector(this.longitude, this.latitude, 0);
+        return convertLonLatToVector(this.longitude, this.latitude, 0);
     }
     set position(position) {
-        const latLonAlt = Convert.convertVectorToLonLat(position);
+        const latLonAlt = convertVectorToLonLat(position);
         this.longitude = latLonAlt.longitude;
         this.latitude = latLonAlt.latitude;
     }
@@ -60,11 +60,62 @@ export class AeroflyNavRouteBase {
         const element = new AeroflyConfigurationNode("tmnav_route_" + this.type, this.identifier, String(index))
             .appendChild("string8u", "Identifier", this.identifier)
             .appendChild("vector3_float64", "Position", this.position, `Lon ${this.longitude.toFixed(6)}, Lat ${this.latitude.toFixed(6)}`)
-            .append(this.uid
-            ? new AeroflyConfigurationNode("uint64", "Uid", this.uid)
-            : new AeroflyConfigurationNodeComment("uint64", "Uid", ""));
+            .appendChild("uint64", "Uid", this.uid ?? this.getUidFallback(), this.uid ? "" : "Fallback UID, not matching Aerofly FS internal UID");
         return element;
     }
+    /**
+     * @returns {bigint} 24 bit longitude
+     * @see https://www.aerofly.com/community/forum/index.php?thread/29490-navdata-coordinates-to-uid/
+     */
+    encodeLongitude() {
+        let scaled = this.longitude / 180;
+        scaled = 65536.0 * (0.5 + 0.5 * scaled); // 16 bit
+        return BigInt(Math.round(256.0 * scaled + 0.5)); // 24 bit
+    }
+    /**
+     * @returns {bigint} 24 bit latitude
+     * @see https://www.aerofly.com/community/forum/index.php?thread/29490-navdata-coordinates-to-uid/
+     */
+    encodeLatitude() {
+        const worldGridConstantA = 2.3311223704144;
+        let scaled = this.latitude / 180;
+        scaled = Math.tan(worldGridConstantA * scaled) / worldGridConstantA;
+        scaled = 65536.0 * (0.5 + 0.5 * scaled); // 16 bit
+        return BigInt(Math.round(256.0 * scaled + 0.5)); // 24 bit
+    }
+    /**
+     * @returns {number} 16 bit type
+     */
+    encodeWaypointType() {
+        // Type code (airport (0500) / runway (0800) / SID (4400) / STAR (4800) / Approach (4C00) / RNAV waypoint (C000) / airways (4000)
+        switch (this.type) {
+            case "origin":
+            case "destination":
+                return 0x0500;
+            case "departure_runway":
+            case "destination_runway":
+                return 0x0800;
+            case "departure":
+                return 0x4400;
+            case "arrival":
+                return 0x4800;
+            case "approach":
+                return 0x4c00;
+        }
+        return 0;
+    }
+    /**
+     * @returns {bigint} Packs both into a single 64-bit value:
+     * - Bits 63..40 → longitude  (24 bit)
+     * - Bits 39..16 → latitude   (24 bit)
+     * - Bits 15..0  → payload    (16 bit)
+     * @see https://www.aerofly.com/community/forum/index.php?thread/29490-navdata-coordinates-to-uid/
+     */
+    getUidFallback() {
+        return ((this.encodeLongitude() << 40n) |
+            (this.encodeLatitude() << 16n) |
+            (BigInt(this.encodeWaypointType()) & 0xffffn));
+    }
     toJSON() {
         return {
             ...this,

package/dist/dto-flight/AeroflyNavRouteBase.test.js

@@ -0,0 +1,26 @@
+import { describe, it } from "node:test";
+import { AeroflyNavRouteDestination } from "../index.js";
+describe("AeroflyNavRouteBase", () => {
+    it("should create a valid AeroflyNavRouteBase structure", () => {
+        const waypoints = [
+            { wp: new AeroflyNavRouteDestination("MAX-NE", 179.999, 89.999), uid: 0n },
+            { wp: new AeroflyNavRouteDestination("MAX-SW", -179.999, -89.999), uid: 0n },
+            { wp: new AeroflyNavRouteDestination("KEYW", -81.7599558, 24.5561197), uid: 5033914504046249216n },
+            { wp: new AeroflyNavRouteDestination("EGLL", -0.45277777, 51.47138888), uid: 9199731073154483456n },
+            { wp: new AeroflyNavRouteDestination("YSSY", 151.177, -33.4961), uid: 16969837613165511936n },
+            { wp: new AeroflyNavRouteDestination("RJTT", 139.779, 35.709), uid: 16385890514078663936n },
+        ];
+        for (const waypoint of waypoints) {
+            console.log(waypoint.wp.getUidFallback(), waypoint.uid);
+        }
+    });
+    it("should test some unpacking of UIDs", () => {
+        const unpackPayload = (packed) => {
+            return Number(packed & 0xffffn);
+        };
+        console.log("KEYW", unpackPayload(5033914504046314752n));
+        console.log("EGLL", unpackPayload(9200173076798702848n));
+        console.log("YSSY", unpackPayload(16969826619723154688n));
+        console.log("RJTT", unpackPayload(16385782762532177152n));
+    });
+});

package/dist/dto-flight/AeroflyNavRouteRunway.js

@@ -1,4 +1,4 @@
-import { Convert } from "../node/Convert.js";
+import { convertFeetToMeter, convertMeterToFeet } from "../node/Convert.js";
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
 import { AeroflyNavRouteBase } from "./AeroflyNavRouteBase.js";
 class AeroflyNavRouteRunway extends AeroflyNavRouteBase {
@@ -27,19 +27,19 @@ class AeroflyNavRouteRunway extends AeroflyNavRouteBase {
      * @returns {number | null} elevation in feet, null if not set
      */
     get elevation_ft() {
-        return this.elevation !== null ? Convert.convertMeterToFeet(this.elevation) : null;
+        return this.elevation !== null ? convertMeterToFeet(this.elevation) : null;
     }
     set elevation_ft(elevation_ft) {
-        this.elevation = elevation_ft !== null ? Convert.convertFeetToMeter(elevation_ft) : null;
+        this.elevation = elevation_ft !== null ? convertFeetToMeter(elevation_ft) : null;
     }
     /**
      * @returns {number | null} runway length in feet, null if not set
      */
     get runwayLength_ft() {
-        return this.runwayLength !== null ? Convert.convertMeterToFeet(this.runwayLength) : null;
+        return this.runwayLength !== null ? convertMeterToFeet(this.runwayLength) : null;
     }
     set runwayLength_ft(runwayLength_ft) {
-        this.runwayLength = runwayLength_ft !== null ? Convert.convertFeetToMeter(runwayLength_ft) : null;
+        this.runwayLength = runwayLength_ft !== null ? convertFeetToMeter(runwayLength_ft) : null;
     }
     /**
      * @returns {AeroflyVector3Float | null} runway direction, null if not set

package/dist/dto-flight/AeroflyNavRouteTransition.js

@@ -1,4 +1,4 @@
-import { Convert } from "../node/Convert.js";
+import { convertFeetToMeter, convertMeterToFeet } from "../node/Convert.js";
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
 import { AeroflyNavRouteBase } from "./AeroflyNavRouteBase.js";
 class AeroflyNavRouteTransition extends AeroflyNavRouteBase {
@@ -29,10 +29,10 @@ class AeroflyNavRouteTransition extends AeroflyNavRouteBase {
      * @returns {number | null} elevation in feet, null if not set
      */
     get elevation_ft() {
-        return this.elevation !== null ? Convert.convertMeterToFeet(this.elevation) : null;
+        return this.elevation !== null ? convertMeterToFeet(this.elevation) : null;
     }
     set elevation_ft(elevation_ft) {
-        this.elevation = elevation_ft !== null ? Convert.convertFeetToMeter(elevation_ft) : null;
+        this.elevation = elevation_ft !== null ? convertFeetToMeter(elevation_ft) : null;
     }
     /**
      * @returns {AeroflyVector3Float} deliberately empty

package/dist/dto-flight/AeroflyNavRouteWaypoint.js

@@ -1,4 +1,4 @@
-import { Convert } from "../node/Convert.js";
+import { convertFeetToMeter, convertLonLatToVector, convertMeterToFeet, convertVectorToLonLat, } from "../node/Convert.js";
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
 import { AeroflyNavRouteBase } from "./AeroflyNavRouteBase.js";
 export class AeroflyNavRouteWaypoint extends AeroflyNavRouteBase {
@@ -9,6 +9,10 @@ export class AeroflyNavRouteWaypoint extends AeroflyNavRouteBase {
      * @property {?number} navaidFrequency if the waypoint is a navaid, its frequency in Hz
      */
     navaidFrequency;
+    /**
+     * @property {?bigint} navaidUid if the waypoint is a navaid, its unique identifier, must match Aerofly FS internal UID if used in an existing mission
+     */
+    navaidUid;
     /**
      * @property {number | null} altitude in meter, null if not set
      */
@@ -23,17 +27,21 @@ export class AeroflyNavRouteWaypoint extends AeroflyNavRouteBase {
      * @param {number} latitude WGS84
      * @param {object} [options] additional options for the waypoint
      * @param {?number} [options.navaidFrequency] if the waypoint is a navaid, its frequency in Hz
+     * @param {?number} [options.navaidFrequency_khz] if the waypoint is a navaid, its frequency in kHz, will override navaidFrequency in Hz if provided
+     * @param {?number} [options.navaidFrequency_mhz] if the waypoint is a navaid, its frequency in MHz, will override navaidFrequency in Hz if provided
+     * @param {?bigint} [options.navaidUid] if the waypoint is a navaid, its unique identifier, must match Aerofly FS internal UID if used in an existing mission
      * @param {number} [options.altitude] in meter
      * @param {?number} [options.altitude_ft] altitude in feet, will override altitude in meter if provided
      * @param {boolean} [options.flyOver] if true, the waypoint is meant to be flown over, otherwise it can be used as a fly-by waypoint
      * @param {?bigint} [options.uid] unique identifier for the waypoint, will be generated automatically if not provided
      */
-    constructor(identifier, longitude, latitude, { navaidFrequency = null, navaidFrequency_khz = null, navaidFrequency_mhz = null, altitude = null, altitude_ft = null, flyOver = false, uid = null, } = {}) {
+    constructor(identifier, longitude, latitude, { navaidFrequency = null, navaidFrequency_khz = null, navaidFrequency_mhz = null, navaidUid = null, altitude = null, altitude_ft = null, flyOver = false, uid = null, } = {}) {
         super("waypoint", identifier, longitude, latitude, { uid });
         this.identifier = identifier;
         this.longitude = longitude;
         this.latitude = latitude;
         this.navaidFrequency = navaidFrequency;
+        this.navaidUid = navaidUid;
         this.altitude = altitude;
         if (altitude_ft !== null) {
             this.altitude_ft = altitude_ft;
@@ -50,10 +58,10 @@ export class AeroflyNavRouteWaypoint extends AeroflyNavRouteBase {
      * @returns {number | null} altitude in feet, null if not set
      */
     get altitude_ft() {
-        return this.altitude !== null ? Convert.convertMeterToFeet(this.altitude) : null;
+        return this.altitude !== null ? convertMeterToFeet(this.altitude) : null;
     }
     set altitude_ft(altitude_ft) {
-        this.altitude = altitude_ft !== null ? Convert.convertFeetToMeter(altitude_ft) : null;
+        this.altitude = altitude_ft !== null ? convertFeetToMeter(altitude_ft) : null;
     }
     get navaidFrequency_khz() {
         return this.navaidFrequency ? this.navaidFrequency / 1000 : null;
@@ -71,20 +79,19 @@ export class AeroflyNavRouteWaypoint extends AeroflyNavRouteBase {
      * @returns {AeroflyVector3Float} to use in Aerofly FS4's `main.mcf`
      */
     get position() {
-        return Convert.convertLonLatToVector(this.longitude, this.latitude, this.altitude || 0);
+        return convertLonLatToVector(this.longitude, this.latitude, this.altitude || 0);
     }
     set position(position) {
-        const { longitude, latitude, altitude_meter } = Convert.convertVectorToLonLat(position);
+        const { longitude, latitude, altitude_meter } = convertVectorToLonLat(position);
         this.longitude = longitude;
         this.latitude = latitude;
         this.altitude = altitude_meter;
     }
     getElement(index = 0) {
         const element = super.getElement(index);
-        if (this.navaidFrequency) {
-            element.appendChild("float64", "NavaidFrequency", this.navaidFrequency);
-        }
         element
+            .appendChild("float64", "NavaidFrequency", this.navaidFrequency ?? 0)
+            .appendChild("uint64", "NavaidUid", this.navaidUid ?? BigInt(0))
             .appendChild("vector2_float64", "Altitude", this.altitude !== null && this.altitude > 0 ? [this.altitude, this.altitude] : [-1001, 100001], `${this.altitude_ft !== null && this.altitude_ft > 0 ? Math.ceil(this.altitude_ft) + " ft" : "unrestricted"}`)
             .appendChild("bool", "FlyOver", this.flyOver);
         return element;
@@ -97,6 +104,7 @@ export class AeroflyNavRouteWaypoint extends AeroflyNavRouteBase {
             altitude_ft: this.altitude_ft,
             navaidFrequency: undefined,
             navaidFrequency_khz: this.navaidFrequency_khz,
+            navaidUid: this.navaidUid !== null ? this.navaidUid.toString() : null,
         };
     }
 }

package/dist/dto-flight/AeroflyNavigationConfig.js

@@ -1,5 +1,5 @@
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
-import { Convert } from "../node/Convert.js";
+import { convertFeetToMeter, convertMeterToFeet } from "../node/Convert.js";
 import { AeroflyNavRouteBase } from "./AeroflyNavRouteBase.js";
 export class AeroflyNavigationConfig {
     /**
@@ -31,16 +31,16 @@ export class AeroflyNavigationConfig {
      * @returns {AeroflyNavigationConfig} with cruise altitude converted to meters
      */
     static createInFeet(cruiseAltitude_ft, waypoints = [], _cruiseSpeed_kts = undefined) {
-        return new AeroflyNavigationConfig(Convert.convertFeetToMeter(cruiseAltitude_ft), waypoints, _cruiseSpeed_kts);
+        return new AeroflyNavigationConfig(convertFeetToMeter(cruiseAltitude_ft), waypoints, _cruiseSpeed_kts);
     }
     /**
      * @returns {number} cruise altitude in feet
      */
     get cruiseAltitude_ft() {
-        return Convert.convertMeterToFeet(this.cruiseAltitude);
+        return convertMeterToFeet(this.cruiseAltitude);
     }
     set cruiseAltitude_ft(cruiseAltitude_ft) {
-        this.cruiseAltitude = Convert.convertFeetToMeter(cruiseAltitude_ft);
+        this.cruiseAltitude = convertFeetToMeter(cruiseAltitude_ft);
     }
     /**
      * @returns {AeroflyConfigurationNode[]} indexed checkpoints

package/dist/dto-flight/AeroflySettingsFlight.js

@@ -1,5 +1,5 @@
-import { Convert } from "../node/Convert.js";
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
+import { convertFeetToMeter, convertLonLatToVector, convertVectorToLonLat, convertDegreeToMatrix, convertMatrixToDegree, convertMeterToFeet, } from "../node/Convert.js";
 export class AeroflySettingsFlight {
     longitude;
     latitude;
@@ -52,7 +52,7 @@ export class AeroflySettingsFlight {
         this.runway = runway;
     }
     static createInFeet(longitude, latitude, altitude_ft, heading_degree, speed_kts = 0, additionalAttributes = {}) {
-        return new AeroflySettingsFlight(longitude, latitude, Convert.convertFeetToMeter(altitude_ft), heading_degree, speed_kts, additionalAttributes);
+        return new AeroflySettingsFlight(longitude, latitude, convertFeetToMeter(altitude_ft), heading_degree, speed_kts, additionalAttributes);
     }
     static createInCartesian(position, velocity, orientation, additionalAttributes = {}) {
         const flight = new AeroflySettingsFlight(0, 0, 0, 0, 0, additionalAttributes);
@@ -95,10 +95,10 @@ export class AeroflySettingsFlight {
      * @returns {AeroflyVector3Float} position vector to use in Aerofly FS4's `main.mcf`
      */
     get position() {
-        return Convert.convertLonLatToVector(this.longitude, this.latitude, this.altitude_meter);
+        return convertLonLatToVector(this.longitude, this.latitude, this.altitude_meter);
     }
     set position(position) {
-        const { longitude, latitude, altitude_meter } = Convert.convertVectorToLonLat(position);
+        const { longitude, latitude, altitude_meter } = convertVectorToLonLat(position);
         this.longitude = longitude;
         this.latitude = latitude;
         this.altitude_meter = altitude_meter;
@@ -116,19 +116,19 @@ export class AeroflySettingsFlight {
         this.speed_ms = 0;
     }
     get orientation() {
-        return Convert.convertDegreeToMatrix(this.heading_degree);
+        return convertDegreeToMatrix(this.heading_degree);
     }
     set orientation(orientation) {
-        this.heading_degree = Convert.convertMatrixToDegree(orientation);
+        this.heading_degree = convertMatrixToDegree(orientation);
     }
     /**
      * @returns {number} altitude in feet AGL
      */
     get altitude_ft() {
-        return Convert.convertMeterToFeet(this.altitude_meter);
+        return convertMeterToFeet(this.altitude_meter);
     }
     set altitude_ft(altitude_ft) {
-        this.altitude_meter = Convert.convertFeetToMeter(altitude_ft);
+        this.altitude_meter = convertFeetToMeter(altitude_ft);
     }
     /**
      * @returns {number} speed in meters per seconds

package/dist/dto-flight/AeroflySettingsFuelLoad.js

@@ -1,5 +1,5 @@
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
-import { Convert } from "../node/Convert.js";
+import { convertKgToLb, convertLbToKg } from "../node/Convert.js";
 export class AeroflySettingsFuelLoad {
     /**
      * @property {string} aircraft  aerofly aircraft name (e.g. "c172")
@@ -34,20 +34,20 @@ export class AeroflySettingsFuelLoad {
         this.configuration = configuration;
     }
     get fuelMass_lb() {
-        return Convert.convertKgToLb(this.fuelMass);
+        return convertKgToLb(this.fuelMass);
     }
     set fuelMass_lb(fuelMass_lb) {
-        this.fuelMass = Convert.convertLbToKg(fuelMass_lb);
+        this.fuelMass = convertLbToKg(fuelMass_lb);
     }
     get payloadMass_lb() {
-        return Convert.convertKgToLb(this.payloadMass);
+        return convertKgToLb(this.payloadMass);
     }
     set payloadMass_lb(payloadMass_lb) {
-        this.payloadMass = Convert.convertLbToKg(payloadMass_lb);
+        this.payloadMass = convertLbToKg(payloadMass_lb);
     }
     getElement() {
         return new AeroflyConfigurationNode("tmsettings_fuel_load", "fuel_load_setting")
-            .appendChild("fuel_load_configuration", "configuration", this.fuelMass > 0 ? "Keep" : this.configuration)
+            .appendChild("fuel_load_configuration", "configuration", this.fuelMass > 0 && this.configuration === "Invalid" ? "Custom" : this.configuration)
             .appendChild("string8u", "aircraft", this.aircraft)
             .appendChild("float64", "fuel_mass", this.fuelMass)
             .appendChild("float64", "payload_mass", this.payloadMass);

package/dist/node/Convert.js

@@ -1,80 +1,115 @@
-export class Convert {
-    static convertLonLatToVector(longitude, latitude, altitude_meter) {
-        const a = 6378137.0;
-        const f = 1.0 / 298.257223563;
-        const e2 = f * (2 - f);
-        const lon = longitude * (Math.PI / 180); // in radians
-        const lat = latitude * (Math.PI / 180); // in radians
-        const h = altitude_meter;
-        const sinLat = Math.sin(lat);
-        const cosLat = Math.cos(lat);
-        const cosLon = Math.cos(lon);
-        const sinLon = Math.sin(lon);
-        const N = a / Math.sqrt(1 - e2 * sinLat * sinLat);
-        const x = (N + h) * cosLat * cosLon;
-        const y = (N + h) * cosLat * sinLon;
-        const z = (N * (1 - e2) + h) * sinLat;
-        return [x, y, z];
-    }
-    static convertVectorToLonLat(coordinates) {
-        // TODO: This implementation is not correct
-        const f = 1.0 / 298.257223563; // WGS84
-        const e2 = 2 * f - f * f;
-        //const lambda = VectorToAngle( coordinates[0], coordinates[1] );
-        let lambda = 0;
-        if (coordinates[0] > 0) {
-            if (coordinates[1] < 0) {
-                lambda = 2 * Math.PI + Math.atan(coordinates[1] / coordinates[0]);
-            }
-            else {
-                lambda = Math.atan(coordinates[1] / coordinates[0]);
-            }
-        }
-        else if (coordinates[0] < 0) {
-            lambda = Math.PI + Math.atan(coordinates[1] / coordinates[0]);
-        }
-        else if (coordinates[1] > 0) {
-            lambda = 0.5 * Math.PI;
+/**
+ * @param {number} longitude in degrees
+ * @param {number} latitude in degrees
+ * @param {number} altitude_meter in meters
+ * @returns {AeroflyVector3Float} for Aerofly
+ */
+export function convertLonLatToVector(longitude, latitude, altitude_meter) {
+    const a = 6378137.0;
+    const f = 1.0 / 298.257223563;
+    const e2 = f * (2 - f);
+    const lon = longitude * (Math.PI / 180); // in radians
+    const lat = latitude * (Math.PI / 180); // in radians
+    const h = altitude_meter;
+    const sinLat = Math.sin(lat);
+    const cosLat = Math.cos(lat);
+    const cosLon = Math.cos(lon);
+    const sinLon = Math.sin(lon);
+    const N = a / Math.sqrt(1 - e2 * sinLat * sinLat);
+    const x = (N + h) * cosLat * cosLon;
+    const y = (N + h) * cosLat * sinLon;
+    const z = (N * (1 - e2) + h) * sinLat;
+    return [x, y, z];
+}
+/**
+ * @param {AeroflyVector3Float} coordinates to convert
+ * @returns {object} as with longitude, latitude, altitude_meter
+ */
+export function convertVectorToLonLat(coordinates) {
+    // TODO: This implementation is not correct
+    const f = 1.0 / 298.257223563; // WGS84
+    const e2 = 2 * f - f * f;
+    //const lambda = VectorToAngle( coordinates[0], coordinates[1] );
+    let lambda = 0;
+    if (coordinates[0] > 0) {
+        if (coordinates[1] < 0) {
+            lambda = 2 * Math.PI + Math.atan(coordinates[1] / coordinates[0]);
         }
         else {
-            lambda = 1.5 * Math.PI;
+            lambda = Math.atan(coordinates[1] / coordinates[0]);
         }
-        const rho = Math.sqrt(coordinates[0] * coordinates[0] + coordinates[1] * coordinates[1]);
-        const phi = Math.atan(coordinates[2] / ((1.0 - e2) * rho));
-        const longitude = (lambda * 180) / Math.PI;
-        const latitude = (phi * 180) / Math.PI;
-        const altitude_meter = rho / Math.cos(phi) - 6378137.0 / Math.sqrt(1 - e2 * Math.sin(phi) * Math.sin(phi));
-        return {
-            longitude: longitude > 180 ? longitude - 360 : longitude,
-            latitude: latitude > 90 ? latitude - 180 : latitude < -90 ? latitude + 180 : latitude,
-            altitude_meter,
-        };
-    }
-    static convertDegreeToMatrix(heading_degree) {
-        // TODO: This implementation is not correct
-        const theta = heading_degree * (Math.PI / 180); // heading in radians
-        const cosTheta = Math.cos(theta);
-        const sinTheta = Math.sin(theta);
-        return [cosTheta, -sinTheta, 0, sinTheta, cosTheta, 0, 0, 0, 1];
-    }
-    static convertMatrixToDegree(orientation) {
-        const headingRad = Math.atan2(orientation[3], orientation[0]);
-        let headingDeg = headingRad * (180 / Math.PI);
-        // Normalize to [0, 360)
-        if (headingDeg < 0)
-            headingDeg += 360;
-        return headingDeg;
-    }
-    static convertMeterToFeet(meter) {
-        return meter * 3.28084;
     }
-    static convertFeetToMeter(feet) {
-        return feet / 3.28084;
+    else if (coordinates[0] < 0) {
+        lambda = Math.PI + Math.atan(coordinates[1] / coordinates[0]);
     }
-    static convertKgToLb(kg) {
-        return kg;
+    else if (coordinates[1] > 0) {
+        lambda = 0.5 * Math.PI;
     }
-    static convertLbToKg(lb) {
-        return lb;
+    else {
+        lambda = 1.5 * Math.PI;
     }
+    const rho = Math.sqrt(coordinates[0] * coordinates[0] + coordinates[1] * coordinates[1]);
+    const phi = Math.atan(coordinates[2] / ((1.0 - e2) * rho));
+    const longitude = (lambda * 180) / Math.PI;
+    const latitude = (phi * 180) / Math.PI;
+    const altitude_meter = rho / Math.cos(phi) - 6378137.0 / Math.sqrt(1 - e2 * Math.sin(phi) * Math.sin(phi));
+    return {
+        longitude: longitude > 180 ? longitude - 360 : longitude,
+        latitude: latitude > 90 ? latitude - 180 : latitude < -90 ? latitude + 180 : latitude,
+        altitude_meter,
+    };
+}
+/**
+ * @param {number} heading_degree in deg
+ * @returns {AeroflyMatrix3Float} for Aerofly
+ */
+export function convertDegreeToMatrix(heading_degree) {
+    // TODO: This implementation is not correct
+    const theta = heading_degree * (Math.PI / 180); // heading in radians
+    const cosTheta = Math.cos(theta);
+    const sinTheta = Math.sin(theta);
+    return [cosTheta, -sinTheta, 0, sinTheta, cosTheta, 0, 0, 0, 1];
+}
+/**
+ * @param {AeroflyMatrix3Float} orientation as Matrxi
+ * @returns {number} heading in degrees
+ * @see https://www.aerofly.com/community/forum/index.php?thread/28025-custom-missions-file-livery-and-parking-position-property/&postID=184313#post184313
+ * @see
+ */
+export function convertMatrixToDegree(orientation) {
+    // TODO: https://www.aerofly.com/community/forum/index.php?thread/28025-custom-missions-file-livery-and-parking-position-property/&postID=184313#post184313
+    const headingRad = Math.atan2(orientation[3], orientation[0]);
+    let headingDeg = headingRad * (180 / Math.PI);
+    // Normalize to [0, 360)
+    if (headingDeg < 0)
+        headingDeg += 360;
+    return headingDeg;
+}
+/**
+ * @param {number} meter in meters
+ * @returns {number} feet
+ */
+export function convertMeterToFeet(meter) {
+    return meter / 0.3048;
+}
+/**
+ * @param {number} feet in feet
+ * @returns {number} meters
+ */
+export function convertFeetToMeter(feet) {
+    return feet * 0.3048;
+}
+/**
+ * @param {number} kg in kilograms
+ * @returns {number} pounds
+ */
+export function convertKgToLb(kg) {
+    return kg / 0.45359237;
+}
+/**
+ * @param {number} lb in pounds
+ * @returns {number} kilograms
+ */
+export function convertLbToKg(lb) {
+    return lb * 0.45359237;
 }