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