Package pygeodesy :: Module ecef :: Class Ecef9Tuple

Class Ecef9Tuple

   object --+        
            |        
        tuple --+    
                |    
   object --+   |    
            |   |    
 named._Named --+    
                |    
named._NamedTuple --+
                    |
                   Ecef9Tuple

9-Tuple (x, y, z, lat, lon, height, C, M, datum) with geocentric x, y and z plus geodetic lat, lon and height, case C (see the Ecef*.reverse methods) and optionally, the rotation matrix M (EcefMatrix) and datum, with lat and lon in degrees and x, y, z and height in meter, conventionally.

Instance Methods

convertDatum(self, datum2)
DEPRECATED, use method toDatum.

toCartesian(self, Cartesian=None, **Cartesian_kwds)
Return the geocentric (x, y, z) coordinates as an ellipsoidal or spherical Cartesian.

toDatum(self, datum2, **name)
Convert this Ecef9Tuple to an other datum.

toLatLon(self, LatLon=None, **LatLon_kwds)
Return the geodetic (lat, lon, height[, datum]) coordinates.

toLocal(self, ltp, Xyz=None, **Xyz_kwds)
Convert this geocentric to local x, y and z.

toVector(self, Vector=None, **Vector_kwds)
Return the geocentric (x, y, z) coordinates as vector.

Inherited from named._NamedTuple: __delattr__, __getattr__, __hash__, __repr__, __setattr__, __str__, dup, items, iteritems, iterunits, reUnit, toRepr, toStr, toUnits, units

Inherited from tuple: __add__, __contains__, __eq__, __ge__, __getattribute__, __getitem__, __getnewargs__, __getslice__, __gt__, __iter__, __le__, __len__, __lt__, __mul__, __ne__, __rmul__, count, index

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

Inherited from object: __format__, __init__, __reduce__, __reduce_ex__, __sizeof__, __subclasshook__

Static Methods
Inherited from `named._NamedTuple`: `__new__`

Properties
	lam
	lamVermeille
	latlon
	latlonheight
	latlonheightdatum
	latlonVermeille
	lonVermeille
	phi
	philam
	philamheight
	philamheightdatum
	philamVermeille
	xyz
	xyzh
Inherited from `named._Named`: `classname`, `classnaming`, `iteration`, `name`, `named`, `named2`, `named3`, `named4`, `sizeof` Inherited from `object`: `__class__`

Method Details

convertDatum (self, datum2)

DEPRECATED, use method toDatum.

Decorators:

@deprecated_method

toCartesian (self, Cartesian=None, **Cartesian_kwds)

Return the geocentric (x, y, z) coordinates as an ellipsoidal or spherical Cartesian.

Arguments:

Cartesian - Optional class to return (x, y, z) (ellipsoidalKarney.Cartesian, ellipsoidalNvector.Cartesian, ellipsoidalVincenty.Cartesian, sphericalNvector.Cartesian or sphericalTrigonometry.Cartesian) or None.
Cartesian_kwds - Optional, additional Cartesian keyword arguments, ignored if Cartesian is None.

Returns:

A Cartesian(x, y, z, **Cartesian_kwds) instance or a Vector4Tuple(x, y, z, h) if Cartesian is None.

Raises:

TypeError - Invalid Cartesian or Cartesian_kwds.

toDatum (self, datum2, **name)

Convert this Ecef9Tuple to an other datum.

Arguments:

datum2 - Datum to convert to (Datum).
name - Optional name=NN (str).

Returns:

The converted 9-Tuple (Ecef9Tuple).

Raises:

TypeError - The datum2 is not a Datum.

toLatLon (self, LatLon=None, **LatLon_kwds)

Return the geodetic (lat, lon, height[, datum]) coordinates.

Arguments:

LatLon - Optional class to return (lat, lon, height[, datum]) or None.
LatLon_kwds - Optional height, datum and other LatLon keyword arguments.

Returns:

An instance of

LatLon(lat, lon, 
          **LatLon_kwds)

or if

LatLon is 
          None

, a LatLon3Tuple(lat, lon, height) respectively LatLon4Tuple

(lat, lon, height, 
          datum)

depending on whether datum is un-/specified.

Raises:

TypeError - Invalid LatLon or LatLon_kwds.

toLocal (self, ltp, Xyz=None, **Xyz_kwds)

Convert this geocentric to local x, y and z.

Arguments:

ltp - The local tangent plane (LTP) to use (Ltp).
Xyz - Optional class to return x, y and z (XyzLocal, Enu, Ned) or None.
Xyz_kwds - Optional, additional Xyz keyword arguments, ignored if Xyz is None.

Returns:

An Xyz instance or if

Xyz is 
          None

, a Local9Tuple

(x, y, z, lat, lon, height, 
          ltp, ecef, M)

with M=None, always.

Raises:

TypeError - Invalid ltp.

toVector (self, Vector=None, **Vector_kwds)

Return the geocentric (x, y, z) coordinates as vector.

Arguments:

Vector - Optional vector class to return (x, y, z) or None.
Vector_kwds - Optional, additional Vector keyword arguments, ignored if Vector is None.

Returns:

A Vector(x, y, z, **Vector_kwds) instance or a Vector3Tuple(x, y, z) if Vector is None.

See Also: Propertes xyz and xyzh

Property Details

lam

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

lamVermeille

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

latlon

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

latlonheight

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

latlonheightdatum

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

latlonVermeille

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

lonVermeille

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

phi

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

philam

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

philamheight

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

philamheightdatum

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

philamVermeille

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

xyz

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

xyzh

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.