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: 19.07.12

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 several 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 several points. Parameters: `points` - Points to be averaged (LatLon[]). `datum` - Optional datum to use (Datum). `height` - Optional height at mean point, overriding the mean height (`meter`). `LatLon` - Optional (sub-)class to return the mean point (LatLon) or `None`. Returns: Geographic mean point and mean height (`LatLon`) or a LatLon3Tuple`(lat, lon, height)` if `LatLon` is `None`. 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 (`meter`). `bearing` - NED vector bearing (compass `degrees360`). `elevation` - NED vector elevation from local coordinate frame horizontal (`degrees`). `name` - Optional name (`str`). Returns: NED vector equivalent to this `distance`, `bearing` and `elevation` (Ned). JS name: fromDistanceBearingElevation.