pygeodesy.ecef.EcefSudano

Class EcefSudano

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

Conversion between geodetic and geocentric, Earth-Centered, Earth-Fixed (ECEF) coordinates based on John J. Sudano's paper.

Instance Methods

reverse(self, xyz, y=None, z=None, M=None, tol=2.220446049250313e-16, **lon00_name)
Convert from geocentric (x, y, z) to geodetic (lat, lon, height) using Sudano's iterative method.

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

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

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

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

Method Details

reverse (self, xyz, y=None, z=None, M=None, tol=2.220446049250313e-16, **lon00_name)

Convert from geocentric (x, y, z) to geodetic (lat, lon, height) using Sudano's iterative method.

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.
tol - Convergence tolerance for sin(latitude) (scalar).
lon00_name - Optional name=NN (str) and optional keyword argument lon00=INT0 (degrees), an arbitrary "polar" longitude returned if x=0 and y=0, see property lon00.

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, 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 no convergence.

Overrides: _EcefBase.reverse

See Also: Class EcefUPC.

Property Details

tolerance

DEPRECATED on 2025.08.22, use keyword argument tol.

Get method:: tolerance(self) - DEPRECATED on 2025.08.22, use keyword argument tol.
Set method:: tolerance(self, tol)