pygeodesy.ecef.EcefFarrell22

Class EcefFarrell22

object --+ | named._Named --+ | named._NamedBase --+ | _EcefBase --+ | EcefFarrell22

Conversion between geodetic and geocentric, Earth-Centered, Earth-Fixed (ECEF) coordinates based on Jay A. Farrell's Table 2.2, page 30.

Instance Methods

reverse(self, xyz, y=None, z=None, M=None, **name_lon00)
Convert from geocentric (x, y, z) to geodetic (lat, lon, height) using Farrell's Table 2.2, page 30.

Inherited from _EcefBase: __eq__, __init__, forward, forward_, toStr

Inherited from named._NamedBase: __repr__, __str__, others, toRepr

Inherited from named._Named: __imatmul__, __matmul__, __rmatmul__, attrs, classof, copy, dup, methodname, rename, toStr2

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __setattr__, __sizeof__, __subclasshook__

Method Details

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

Convert from geocentric (x, y, z) to geodetic (lat, lon, height) using Farrell's Table 2.2, page 30.

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 sqrt domain or zero division error.

Overrides: _EcefBase.reverse

See Also: EcefFarrell21 and EcefVeness.