Package pygeodesy :: Module ellipsoidalNvector |
[frames] | no frames]

# Module ellipsoidalNvector

N-vector-based ellipsoidal geodetic (lat-/longitude) and cartesion (x/y/z) classes LatLon, Ned, Nvector and Cartesian and functions meanOf and toNed.

Pure Python implementation of n-vector-based geodetic (lat-/longitude) methods by (C) Chris Veness 2011-2016 published under the same MIT Licence**, see Vector-based geodesy.

These classes and functions work with: (a) geodesic (polar) lat-/longitude points on the earth's surface and (b) 3-D vectors used as n-vectors representing points on the earth's surface or vectors normal to the plane of a great circle.

See also Kenneth Gade 'A Non-singular Horizontal Position Representation', The Journal of Navigation (2010), vol 63, nr 3, pp 395-417.

Version: 18.09.23

Classes
| LatLon An n-vector-based ellipsoidal LatLon point.
| Cartesian Extended to convert (geocentric) Cartesian points to (ellipsoidal) Nvector and n-vector-based geodetic LatLon.
| Ned North-Eeast-Down (NED), also known as Local Tangent Plane (LTP), is a vector in the local coordinate frame of a body.
| Nvector An n-vector is a position representation using a (unit) vector normal to the earth ellipsoid.

Functions
meanOf(points, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran`...`, height=None, LatLon=<class 'pygeodesy.ellipsoidalNvector.LatLon'>) Compute the geographic mean of the supplied points. |
toNed(distance, bearing, elevation, name=`'````'`) Create an NED vector from distance, bearing and elevation (in local coordinate system). |

Function Details

### meanOf(points, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran`...`, height=None, LatLon=<class 'pygeodesy.ellipsoidalNvector.LatLon'>) |
Compute the geographic mean of the supplied points. Parameters: `points` - Array of points to be averaged (LatLon[]). `datum` - Optional datum to use (Datum). `height` - Optional height, overriding the mean height (meter). `LatLon` - Optional LatLon class for the mean point (LatLon). Returns: Point at geographic mean and mean height (LatLon). Raises: `ValueError` - Insufficient number of points.

### toNed(distance, bearing, elevation, name=`'````'`) |
Create an NED vector from distance, bearing and elevation (in local coordinate system). Parameters: `distance` - NED vector length in meter (scalar). `bearing` - NED vector bearing in compass degrees (scalar). `elevation` - NED vector elevation in degrees from local coordinate frame horizontal (scalar). `name` - Optional name (string). Returns: NED vector equivalent to this distance, bearing and elevation (Ned). JS name: fromDistanceBearingElevation.