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

Module ellipsoidalNvector

N-vector-based classes geodetic (lat-/longitude) LatLon, geocentric (ECEF) Cartesian, Ned and Nvector and functions meanOf and toNed, all ellipsoidal.

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.10.31

Classes
  Cartesian
Extended to convert geocentric, Cartesian points to Nvector and n-vector-based, geodetic LatLon.
  LatLon
An n-vector-based, ellipsoidal LatLon point.
  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.
 
sumOf(nvectors, Vector=<class 'pygeodesy.ellipsoidalNvector.Nvector'>, h=None, **kwds)
Return the vectorial sum of two or more n-vectors.
 
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.

sumOf(nvectors, Vector=<class 'pygeodesy.ellipsoidalNvector.Nvector'>, h=None, **kwds)

 

Return the vectorial sum of two or more n-vectors.

Parameters:
  • nvectors - Vectors to be added (Nvector[]).
  • Vector - Optional class for the vectorial sum (Nvector).
  • h - Optional height, overriding the mean height (meter).
  • kwds - Optional, additional Vector keyword arguments.
Returns:
Vectorial sum (Vector).
Raises:

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.