The @math.gl/geospatial
module provides support for ellipsoidal math, focusing on geospatial use cases.
It provides classes and utilities to facilitate working with ellipsoidal geospatial coordinate systems and projections used with computer maps, primarily WGS84 (World Geodetic System) coordinates.
Class | Description |
---|---|
Ellipsoid | Implements ellipsoid |
Ellipsoid.WSG84 | An Ellipsoid instance initialized with Earth radii per WGS84. |
A major use of this library is to convert between "cartesian" (x
, y
, z
) and "cartographic" (longitude
, latitude
, height
) representations of WSG84 coordinates. The Ellipsoid
class implements these calculations.
Determine the Cartesian representation of a Cartographic position on a WGS84 ellipsoid.
import {toRadians} from '@math.gl/core';
import {Ellipsoid} from '@math.gl/geospatial';
const cartographicPosition = [toRadians(21), toRadians(78), 5000];
const cartesianPosition = Ellipsoid.WGS84.cartographicToCartesian(cartographicPosition);
Determine the Cartographic representation of a Cartesian position on a WGS84 ellipsoid.
import {Ellipsoid} from '@math.gl/geospatial';
const cartesianPosition = [17832.12, 83234.52, 952313.73];
const cartographicPosition = Ellipsoid.WGS84.cartesianToCartographic(cartesianPosition);
Get the transform from local east-north-up at cartographic (0.0, 0.0) to Earth's fixed frame.
import {Ellipsoid} from '@math.gl/geospatial';
const transformMatrix = Ellipsoid.WGS84.eastNorthUpToFixedFrame([0, 0, 0]);
Like all non-core math.gl modules, this module can be used independently of core math.gl classes.
Array
instances of length 3, or objects with x
, y
, z
elements.This library was initially created as part of a bigger collaboration between the vis.gl and Cesium teams to provide framework-independent, portable support for the 3D Tiles specification, however it has been designed to provide generic support for WGS84 and ellipsoidal math.
This code is a fork of selected classes in the Cesium code base, under the Apache 2 License.