@math.gl/geospatial

What is @math.gl/geospatial?

@math.gl/geospatial is a library that provides geospatial math utilities for handling and manipulating geographic data. It includes functions for coordinate transformations, geodesic calculations, and other spatial operations.

What are @math.gl/geospatial's main functionalities?

Coordinate Transformations

This feature allows you to transform coordinates from one system to another. In this example, we convert geographic coordinates (longitude, latitude, altitude) to Cartesian coordinates.

const { Ellipsoid } = require('@math.gl/geospatial');
const wgs84 = Ellipsoid.WGS84;
const cartesian = wgs84.cartographicToCartesian([0.1, 0.1, 0]);
console.log(cartesian);

Geodesic Calculations

This feature allows you to perform geodesic calculations, such as finding the distance between two points on the surface of an ellipsoid. In this example, we calculate the surface distance between two geographic points.

const { Ellipsoid, EllipsoidGeodesic } = require('@math.gl/geospatial');
const wgs84 = Ellipsoid.WGS84;
const geodesic = new EllipsoidGeodesic([0.1, 0.1], [0.2, 0.2], wgs84);
console.log(geodesic.surfaceDistance);

Bounding Volumes

This feature allows you to compute bounding volumes for a set of points. In this example, we create a bounding sphere that encompasses a set of 3D points.

const { BoundingSphere } = require('@math.gl/geospatial');
const points = [[0, 0, 0], [1, 1, 1], [2, 2, 2]];
const boundingSphere = BoundingSphere.fromPoints(points);
console.log(boundingSphere);

Other packages similar to @math.gl/geospatial

turf

Turf is a JavaScript library for advanced geospatial analysis. It provides a wide range of spatial operations, including transformations, measurements, and data manipulation. Compared to @math.gl/geospatial, Turf offers a more extensive set of geospatial functions but may be more complex to use for simple tasks.

proj4

Proj4 is a library for performing coordinate transformations. It supports a wide range of coordinate reference systems and is widely used in the geospatial community. While @math.gl/geospatial also supports coordinate transformations, Proj4 is more specialized and offers more comprehensive support for different coordinate systems.

geolib

Geolib is a library for geospatial calculations, including distance, area, and bounding box calculations. It is simpler and more lightweight compared to @math.gl/geospatial, making it suitable for basic geospatial tasks.

README

@math.gl/geospatial

math.gl is a suite of math modules for 3D and geospatial applications.

This module contains geospatial math, for dealing with the WGS84 (World Geodetic System) coordinate system etc.

For documentation please visit the website.

Changelog

v3.3.0-alpha.1 - Aug 14, 2020

• proj4: new module for coordinate system conversion (#161)
• Bump elliptic from 6.5.1 to 6.5.3 (#160)
• Bump lodash from 4.17.15 to 4.17.19 (#159)