pygeodesy.ecef.EcefYou

Conversion between geodetic and geocentric, Earth-Centered, Earth-Fixed (ECEF) coordinates using Rey-Jer You's transformation for non-prolate ellipsoids.

init (self, a_ellipsoid=Ellipsoid(name='WGS84', a=6378137, b=6356752.31424518, f_=298.`...`, f=None, **name_lon00)
(Constructor)

New Ecef* converter.

Arguments:

a_ellipsoid - A (non-prolate) ellipsoid (Ellipsoid, Ellipsoid2, Datum or a_f2Tuple) or scalar ellipsoid's equatorial radius (meter).
f - None or the ellipsoid flattening (scalar), required for scalar a_ellipsoid, f=0 represents a sphere, negative f a prolate ellipsoid.
name - Optional name (str).
lon00 - An arbitrary, "polar" longitude (degrees), see the methods reverse.

Raises:

EcefError - If a_ellipsoid not Ellipsoid, Ellipsoid2, Datum or a_f2Tuple or scalar or f not scalar or if scalar a_ellipsoid not positive or f not less than 1.0.

Overrides: object.__init__

(inherited documentation)

reverse (self, xyz, y=None, z=None, M=None, **name_lon00)

Convert geocentric (x, y, z) to geodetic (lat, lon, height) using Rey-Jer You's transformation.

Arguments:

xyz - A geocentric (Cartesian, Ecef9Tuple) or scalar ECEF x coordinate (meter).
y - ECEF y coordinate for scalar xyz and z (meter).
z - ECEF z coordinate for scalar xyz and y (meter).
M - Ignored, rotation matrix M not available.
name_lon00 - Optional keyword arguments name=NN (str) and "polar" longitude lon00=INT0 (degrees), overriding the default and property lon00 setting and returned in case x=0 and y=0.

Returns:

An Ecef9Tuple

(x, y, z, lat, lon, height, C, 
          M, datum)

with geodetic coordinates

(lat, lon, 
          height)

for the given geocentric ones

(x, y, 
          z)

, case C=1, M=None always and datum if available.

Raises:

EcefError - Invalid xyz or scalar x or y and/or z not scalar for scalar xyz or the ellipsoid is prolate.

Overrides: _EcefBase.reverse

Class EcefYou

__init__ (self, a_ellipsoid=Ellipsoid(name='WGS84', a=6378137, b=6356752.31424518, f_=298...., f=None, **name_lon00) (Constructor)

reverse (self, xyz, y=None, z=None, M=None, **name_lon00)

init (self, a_ellipsoid=Ellipsoid(name='WGS84', a=6378137, b=6356752.31424518, f_=298.`...`, f=None, **name_lon00)
(Constructor)