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