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 http://www.movable-type.co.uk/scripts/latlong-vectors.html'

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 Kenneth Gade, "A Non-singular Horizontal Position Representation", The Journal of Navigation (2010), vol 63, nr 3, pp 395-417. Also at http://www.navlab.net/Publications/A_Nonsingular_Horizontal_Position_Representation.pdf.


Version: 17.05.26

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'>)
Returns the geographic mean of the supplied points.
 
toNed(distance, bearing, elevation)
Creates 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'>)

 

Returns 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 - LatLon class for the mean point (LatLon).
Returns:
Point at geographic mean and mean height (LatLon).
Raises:
  • ValueError - Too few points.

toNed(distance, bearing, elevation)

 

Creates 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).
Returns:
NED vector equivalent to distance, bearing and elevation (Ned).

JS name: fromDistanceBearingElevation.