@onerjs/core 8.42.7 → 8.42.9

package/Maths/math.geospatial.d.ts

@@ -5,8 +5,23 @@ export interface ILatLonLike {
     /** Longitude in radians. */
     lon: number;
 }
-/** Latitude and longitude in radians, and altitude in meters. */
+/** Latitude and longitude in radians, and altitude, typically meters. */
 export interface ILatLonAltLike extends ILatLonLike {
-    /** The height above the surface in meters. */
+    /** The height above the surface, typically meters. */
     alt: number;
 }
+/**
+ * A reference ellipsoid used for geospatial functions.
+ */
+export interface IEllipsoidLike {
+    /** The larger radius for the ellipsoid. */
+    semiMajorAxis: number;
+    /** The smaller radius for the ellipsoid. */
+    semiMinorAxis: number;
+    /** The flattening for the ellipsoid. Zero for a sphere. */
+    flattening: number;
+    /** The first eccentricity, squared. */
+    firstEccentricitySquared: number;
+    /** The second eccentricity, squared. */
+    secondEccentricitySquared: number;
+}

package/Maths/math.geospatial.functions.d.ts

@@ -1,6 +1,11 @@
 import type { DeepImmutable } from "../types.js";
-import type { ILatLonLike } from "./math.geospatial.js";
+import type { IEllipsoidLike, ILatLonAltLike, ILatLonLike } from "./math.geospatial.js";
 import type { IVector3Like } from "./math.like.js";
+/**
+ * The WGS84 reference ellipsoid used for Earth-related geospatial functions.
+ * Derived from the semi-major axis (meters) and the inverse flattening.
+ */
+export declare const Wgs84Ellipsoid: DeepImmutable<IEllipsoidLike>;
 /**
  * Converts the latitude and longitude specified in degrees to an {@link ILatLonLike} in radians.
  * @param lat - The latitude in degrees
@@ -11,9 +16,18 @@ import type { IVector3Like } from "./math.like.js";
 export declare function LatLonFromDegreesToRef<T extends ILatLonLike>(lat: number, lon: number, result: T): T;
 /**
  * Computes the normal (up direction) in ECEF (Earth-Centered, Earth-Fixed) coordinates from the specified latitude and longitude in radians.
- * Will clamp the latitude to -PI/2 to PI/2.
+ * For the calculation, latitude is clamped to -PI/2 to PI/2.
  * @param latLon - The latitude and longitude in radians
  * @param result - The resulting normal
  * @returns The resulting normal
  */
 export declare function LatLonToNormalToRef<T extends IVector3Like>(latLon: DeepImmutable<ILatLonLike>, result: T): T;
+/**
+ * Converts latitude, longitude, and altitude to an ECEF (Earth-Centered, Earth-Fixed) position using the specified ellipsoid.
+ * For the calculation, latitude is clamped to -PI/2 to PI/2.
+ * @param latLonAlt - The latitude and longitude in radians, and the altitude relative to the reference ellipsoid's surface.
+ * @param ellipsoid - Parameters for a reference ellipsoid (e.g., the {@link Wgs84Ellipsoid}).
+ * @param result - The resulting ECEF position
+ * @returns The resulting ECEF position
+ */
+export declare function EcefFromLatLonAltToRef<T extends IVector3Like>(latLonAlt: DeepImmutable<ILatLonAltLike>, ellipsoid: DeepImmutable<Pick<IEllipsoidLike, "semiMajorAxis" | "firstEccentricitySquared">>, result: T): T;

package/Maths/math.geospatial.functions.js

@@ -1,5 +1,19 @@
 import { Clamp } from "./math.scalar.functions.js";
 import { Vector3FromFloatsToRef } from "./math.vector.functions.js";
+const HalfPi = Math.PI / 2;
+const DegreesToRadians = Math.PI / 180;
+const EllipsoidFromSemiMajorAxisAndInverseFlattening = (semiMajorAxis, inverseFlattening) => {
+    const flattening = 1 / inverseFlattening;
+    const semiMinorAxis = semiMajorAxis * (1 - flattening);
+    const firstEccentricitySquared = 2 * flattening - flattening * flattening;
+    const secondEccentricitySquared = firstEccentricitySquared / (1 - firstEccentricitySquared);
+    return { semiMajorAxis, semiMinorAxis, flattening, firstEccentricitySquared, secondEccentricitySquared };
+};
+/**
+ * The WGS84 reference ellipsoid used for Earth-related geospatial functions.
+ * Derived from the semi-major axis (meters) and the inverse flattening.
+ */
+export const Wgs84Ellipsoid = Object.freeze(EllipsoidFromSemiMajorAxisAndInverseFlattening(6378137.0, 298.257223563));
 /**
  * Converts the latitude and longitude specified in degrees to an {@link ILatLonLike} in radians.
  * @param lat - The latitude in degrees
@@ -8,20 +22,39 @@ import { Vector3FromFloatsToRef } from "./math.vector.functions.js";
  * @returns The resulting {@link ILatLonLike} in radians
  */
 export function LatLonFromDegreesToRef(lat, lon, result) {
-    result.lat = (lat * Math.PI) / 180;
-    result.lon = (lon * Math.PI) / 180;
+    result.lat = lat * DegreesToRadians;
+    result.lon = lon * DegreesToRadians;
     return result;
 }
 /**
  * Computes the normal (up direction) in ECEF (Earth-Centered, Earth-Fixed) coordinates from the specified latitude and longitude in radians.
- * Will clamp the latitude to -PI/2 to PI/2.
+ * For the calculation, latitude is clamped to -PI/2 to PI/2.
  * @param latLon - The latitude and longitude in radians
  * @param result - The resulting normal
  * @returns The resulting normal
  */
 export function LatLonToNormalToRef(latLon, result) {
-    const lat = Clamp(latLon.lat, -Math.PI / 2, Math.PI / 2);
+    const lat = Clamp(latLon.lat, -HalfPi, HalfPi);
     const cosLat = Math.cos(lat);
     return Vector3FromFloatsToRef(cosLat * Math.cos(latLon.lon), cosLat * Math.sin(latLon.lon), Math.sin(lat), result);
 }
+/**
+ * Converts latitude, longitude, and altitude to an ECEF (Earth-Centered, Earth-Fixed) position using the specified ellipsoid.
+ * For the calculation, latitude is clamped to -PI/2 to PI/2.
+ * @param latLonAlt - The latitude and longitude in radians, and the altitude relative to the reference ellipsoid's surface.
+ * @param ellipsoid - Parameters for a reference ellipsoid (e.g., the {@link Wgs84Ellipsoid}).
+ * @param result - The resulting ECEF position
+ * @returns The resulting ECEF position
+ */
+export function EcefFromLatLonAltToRef(latLonAlt, ellipsoid, result) {
+    const lat = Clamp(latLonAlt.lat, -HalfPi, HalfPi);
+    const { lon, alt } = latLonAlt;
+    const { semiMajorAxis, firstEccentricitySquared } = ellipsoid;
+    const sinLat = Math.sin(lat);
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    const N = semiMajorAxis / Math.sqrt(1 - firstEccentricitySquared * sinLat * sinLat);
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    const NPlusAltTimesCosLat = (N + alt) * Math.cos(lat);
+    return Vector3FromFloatsToRef(NPlusAltTimesCosLat * Math.cos(lon), NPlusAltTimesCosLat * Math.sin(lon), (N * (1 - firstEccentricitySquared) + alt) * sinLat, result);
+}
 //# sourceMappingURL=math.geospatial.functions.js.map

package/Maths/math.geospatial.functions.js.map

@@ -1 +1 @@
-{"version":3,"file":"math.geospatial.functions.js","sourceRoot":"","sources":["../../../../dev/core/src/Maths/math.geospatial.functions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAIhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAwB,GAAW,EAAE,GAAW,EAAE,MAAS;IAC7F,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IACnC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IACnC,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAyB,MAAkC,EAAE,MAAS;IACrG,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,sBAAsB,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AACvH,CAAC","sourcesContent":["import { Clamp } from \"./math.scalar.functions\";\r\nimport type { DeepImmutable } from \"../types\";\r\nimport type { ILatLonLike } from \"./math.geospatial\";\r\nimport type { IVector3Like } from \"./math.like\";\r\nimport { Vector3FromFloatsToRef } from \"./math.vector.functions\";\r\n\r\n/**\r\n * Converts the latitude and longitude specified in degrees to an {@link ILatLonLike} in radians.\r\n * @param lat - The latitude in degrees\r\n * @param lon - The longitude in degrees\r\n * @param result - The resulting {@link ILatLonLike} in radians\r\n * @returns The resulting {@link ILatLonLike} in radians\r\n */\r\nexport function LatLonFromDegreesToRef<T extends ILatLonLike>(lat: number, lon: number, result: T): T {\r\n    result.lat = (lat * Math.PI) / 180;\r\n    result.lon = (lon * Math.PI) / 180;\r\n    return result;\r\n}\r\n\r\n/**\r\n * Computes the normal (up direction) in ECEF (Earth-Centered, Earth-Fixed) coordinates from the specified latitude and longitude in radians.\r\n * Will clamp the latitude to -PI/2 to PI/2.\r\n * @param latLon - The latitude and longitude in radians\r\n * @param result - The resulting normal\r\n * @returns The resulting normal\r\n */\r\nexport function LatLonToNormalToRef<T extends IVector3Like>(latLon: DeepImmutable<ILatLonLike>, result: T): T {\r\n    const lat = Clamp(latLon.lat, -Math.PI / 2, Math.PI / 2);\r\n    const cosLat = Math.cos(lat);\r\n    return Vector3FromFloatsToRef(cosLat * Math.cos(latLon.lon), cosLat * Math.sin(latLon.lon), Math.sin(lat), result);\r\n}\r\n"]}
+{"version":3,"file":"math.geospatial.functions.js","sourceRoot":"","sources":["../../../../dev/core/src/Maths/math.geospatial.functions.ts"],"names":[],"mappings":"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","sourcesContent":["import { Clamp } from \"./math.scalar.functions\";\r\nimport type { DeepImmutable } from \"../types\";\r\nimport type { IEllipsoidLike, ILatLonAltLike, ILatLonLike } from \"./math.geospatial\";\r\nimport type { IVector3Like } from \"./math.like\";\r\nimport { Vector3FromFloatsToRef } from \"./math.vector.functions\";\r\n\r\nconst HalfPi = Math.PI / 2;\r\nconst DegreesToRadians = Math.PI / 180;\r\n\r\nconst EllipsoidFromSemiMajorAxisAndInverseFlattening = (semiMajorAxis: number, inverseFlattening: number): IEllipsoidLike => {\r\n    const flattening = 1 / inverseFlattening;\r\n    const semiMinorAxis = semiMajorAxis * (1 - flattening);\r\n    const firstEccentricitySquared = 2 * flattening - flattening * flattening;\r\n    const secondEccentricitySquared = firstEccentricitySquared / (1 - firstEccentricitySquared);\r\n    return { semiMajorAxis, semiMinorAxis, flattening, firstEccentricitySquared, secondEccentricitySquared };\r\n};\r\n\r\n/**\r\n * The WGS84 reference ellipsoid used for Earth-related geospatial functions.\r\n * Derived from the semi-major axis (meters) and the inverse flattening.\r\n */\r\nexport const Wgs84Ellipsoid: DeepImmutable<IEllipsoidLike> = Object.freeze(EllipsoidFromSemiMajorAxisAndInverseFlattening(6378137.0, 298.257223563));\r\n\r\n/**\r\n * Converts the latitude and longitude specified in degrees to an {@link ILatLonLike} in radians.\r\n * @param lat - The latitude in degrees\r\n * @param lon - The longitude in degrees\r\n * @param result - The resulting {@link ILatLonLike} in radians\r\n * @returns The resulting {@link ILatLonLike} in radians\r\n */\r\nexport function LatLonFromDegreesToRef<T extends ILatLonLike>(lat: number, lon: number, result: T): T {\r\n    result.lat = lat * DegreesToRadians;\r\n    result.lon = lon * DegreesToRadians;\r\n    return result;\r\n}\r\n\r\n/**\r\n * Computes the normal (up direction) in ECEF (Earth-Centered, Earth-Fixed) coordinates from the specified latitude and longitude in radians.\r\n * For the calculation, latitude is clamped to -PI/2 to PI/2.\r\n * @param latLon - The latitude and longitude in radians\r\n * @param result - The resulting normal\r\n * @returns The resulting normal\r\n */\r\nexport function LatLonToNormalToRef<T extends IVector3Like>(latLon: DeepImmutable<ILatLonLike>, result: T): T {\r\n    const lat = Clamp(latLon.lat, -HalfPi, HalfPi);\r\n    const cosLat = Math.cos(lat);\r\n    return Vector3FromFloatsToRef(cosLat * Math.cos(latLon.lon), cosLat * Math.sin(latLon.lon), Math.sin(lat), result);\r\n}\r\n\r\n/**\r\n * Converts latitude, longitude, and altitude to an ECEF (Earth-Centered, Earth-Fixed) position using the specified ellipsoid.\r\n * For the calculation, latitude is clamped to -PI/2 to PI/2.\r\n * @param latLonAlt - The latitude and longitude in radians, and the altitude relative to the reference ellipsoid's surface.\r\n * @param ellipsoid - Parameters for a reference ellipsoid (e.g., the {@link Wgs84Ellipsoid}).\r\n * @param result - The resulting ECEF position\r\n * @returns The resulting ECEF position\r\n */\r\nexport function EcefFromLatLonAltToRef<T extends IVector3Like>(\r\n    latLonAlt: DeepImmutable<ILatLonAltLike>,\r\n    ellipsoid: DeepImmutable<Pick<IEllipsoidLike, \"semiMajorAxis\" | \"firstEccentricitySquared\">>,\r\n    result: T\r\n): T {\r\n    const lat = Clamp(latLonAlt.lat, -HalfPi, HalfPi);\r\n    const { lon, alt } = latLonAlt;\r\n    const { semiMajorAxis, firstEccentricitySquared } = ellipsoid;\r\n    const sinLat = Math.sin(lat);\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    const N = semiMajorAxis / Math.sqrt(1 - firstEccentricitySquared * sinLat * sinLat);\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    const NPlusAltTimesCosLat = (N + alt) * Math.cos(lat);\r\n    return Vector3FromFloatsToRef(NPlusAltTimesCosLat * Math.cos(lon), NPlusAltTimesCosLat * Math.sin(lon), (N * (1 - firstEccentricitySquared) + alt) * sinLat, result);\r\n}\r\n"]}

package/Maths/math.geospatial.js.map

@@ -1 +1 @@
-{"version":3,"file":"math.geospatial.js","sourceRoot":"","sources":["../../../../dev/core/src/Maths/math.geospatial.ts"],"names":[],"mappings":"","sourcesContent":["/** Latitude and longitude in radians. */\r\nexport interface ILatLonLike {\r\n    /** Latitude in radians. */\r\n    lat: number;\r\n    /** Longitude in radians. */\r\n    lon: number;\r\n}\r\n\r\n/** Latitude and longitude in radians, and altitude in meters. */\r\nexport interface ILatLonAltLike extends ILatLonLike {\r\n    /** The height above the surface in meters. */\r\n    alt: number;\r\n}\r\n"]}
+{"version":3,"file":"math.geospatial.js","sourceRoot":"","sources":["../../../../dev/core/src/Maths/math.geospatial.ts"],"names":[],"mappings":"","sourcesContent":["/** Latitude and longitude in radians. */\r\nexport interface ILatLonLike {\r\n    /** Latitude in radians. */\r\n    lat: number;\r\n    /** Longitude in radians. */\r\n    lon: number;\r\n}\r\n\r\n/** Latitude and longitude in radians, and altitude, typically meters. */\r\nexport interface ILatLonAltLike extends ILatLonLike {\r\n    /** The height above the surface, typically meters. */\r\n    alt: number;\r\n}\r\n\r\n/**\r\n * A reference ellipsoid used for geospatial functions.\r\n */\r\nexport interface IEllipsoidLike {\r\n    /** The larger radius for the ellipsoid. */\r\n    semiMajorAxis: number;\r\n    /** The smaller radius for the ellipsoid. */\r\n    semiMinorAxis: number;\r\n    /** The flattening for the ellipsoid. Zero for a sphere. */\r\n    flattening: number;\r\n    /** The first eccentricity, squared. */\r\n    firstEccentricitySquared: number;\r\n    /** The second eccentricity, squared. */\r\n    secondEccentricitySquared: number;\r\n}\r\n"]}

package/Maths/math.path.js

@@ -1067,7 +1067,7 @@ export class Curve3 {
         else {
             const dStep = 1 / steps;
             let theta = 0;
-            let point = Vector3.Zero();
+            let point;
             do {
                 point = center.add(xAxis.scale(radius * Math.cos(theta)).add(yAxis.scale(radius * Math.sin(theta))));
                 copyOrPush(point);