Package pygeodesy :: Module ecef :: Class Ecef9Tuple |
[frames] | no frames]

# 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) 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__`, `__getitem__`, `__repr__`, `__setattr__`, `__str__`, `dup`, `items`, `iteritems`, `iterunits`, `toRepr`, `toStr`, `toUnits`, `units` Inherited from `tuple`: `__add__`, `__contains__`, `__eq__`, `__ge__`, `__getattribute__`, `__getnewargs__`, `__getslice__`, `__gt__`, `__hash__`, `__iter__`, `__le__`, `__len__`, `__lt__`, `__mul__`, `__ne__`, `__rmul__`, `count`, `index` Inherited from `named._Named`: `_DOT_`, `__imatmul__`, `__matmul__`, `__rmatmul__`, `attrs`, `classof`, `copy`, `rename`, `toStr2` Inherited from `object`: `__format__`, `__init__`, `__reduce__`, `__reduce_ex__`, `__sizeof__`, `__subclasshook__`

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

Class Variables
| _Names_ = ``(``'``x``'``,` `'``y``'``,` `'``z``'``,` `'``lat``'``,` `'``lon``'``,` `'``height``'``,` `'``C``'``,` `'``M``'``,` `'``d``...`` Tuple specifying the `name` of each `Named-Tuple` item.
| _Units_ = ``(`<class 'pygeodesy.units.Meter'>`,` <class 'pygeodesy.`...`` Tuple defining the `units` of the value of each `Named-Tuple` item.

Properties
| lam Get the longitude in `radians` (`float`).
| lamVermeille Get the longitude in `radians [-PI*3/2..+PI*3/2]` after Vermeille (2004), p 95.
| latlon Get the lat-, longitude in `degrees` (LatLon2Tuple`(lat, lon)`).
| latlonheight Get the lat-, longitude in `degrees` and height (LatLon3Tuple`(lat, lon, height)`).
| latlonheightdatum Get the lat-, longitude in `degrees` with height and datum (LatLon4Tuple`(lat, lon, height, datum)`).
| latlonVermeille Get the latitude and Vermeille longitude in `degrees [-225..+225]` (LatLon2Tuple`(lat, lon)`).
| lonVermeille Get the longitude in `degrees [-225..+225]` after Vermeille (2004), p 95.
| phi Get the latitude in `radians` (`float`).
| philam Get the lat-, longitude in `radians` (PhiLam2Tuple`(phi, lam)`).
| philamheight Get the lat-, longitude in `radians` and height (PhiLam3Tuple`(phi, lam, height)`).
| philamheightdatum Get the lat-, longitude in `radians` with height and datum (PhiLam4Tuple`(phi, lam, height, datum)`).
| philamVermeille Get the latitude and Vermeille longitude in `radians [-PI*3/2..+PI*3/2]` (PhiLam2Tuple`(phi, lam)`).
| xyz Get the geocentric `(x, y, z)` coordinates (Vector3Tuple`(x, y, z)`).
| xyzh Get the geocentric `(x, y, z)` coordinates and `height` (Vector4Tuple`(x, y, z, h)`)
Inherited from `named._NamedTuple`: `iteration` Inherited from `named._Named`: `classname`, `classnaming`, `name`, `named`, `named2`, `named3`, `named4` 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) |
Convert this `Ecef9Tuple` to an other datum. Arguments: `datum2` - Datum to convert to (Datum). 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`

Class Variable Details

  ### _Names_ Tuple specifying the `name` of each `Named-Tuple` item. Note: Specify at least 2 item names. Value:
      ('x', 'y', 'z', 'lat', 'lon', 'height', 'C', 'M', 'datum')

  ### _Units_ Tuple defining the `units` of the value of each `Named-Tuple` item. Note: The `len(_Units_)` must match `len(_Names_)`. Value:
      (<class 'pygeodesy.units.Meter'>,
       <class 'pygeodesy.units.Meter'>,
       <class 'pygeodesy.units.Meter'>,
       <class 'pygeodesy.units.Lat'>,
       <class 'pygeodesy.units.Lon'>,
       <class 'pygeodesy.units.Height'>,
       <class 'pygeodesy.units.Int'>,
       <function _Pass at 0x7f8ac0459950>,
      ...

Property Details

### lam Get the longitude in `radians` (`float`). Get method: lam(self) - Get the longitude in `radians` (`float`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.

### lamVermeille Get the longitude in `radians [-PI*3/2..+PI*3/2]` after Vermeille (2004), p 95. Get method: lamVermeille(self) - Get the longitude in `radians [-PI*3/2..+PI*3/2]` after Vermeille (2004), p 95. Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value. See Also: Karney, Vermeille 2011, pp 112-113, 116 and Featherstone, et.al., p 7.

### latlon Get the lat-, longitude in `degrees` (LatLon2Tuple`(lat, lon)`). Get method: latlon(self) - Get the lat-, longitude in `degrees` (LatLon2Tuple`(lat, lon)`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.

### latlonheight Get the lat-, longitude in `degrees` and height (LatLon3Tuple`(lat, lon, height)`). Get method: latlonheight(self) - Get the lat-, longitude in `degrees` and height (LatLon3Tuple`(lat, lon, height)`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.

### latlonheightdatum Get the lat-, longitude in `degrees` with height and datum (LatLon4Tuple`(lat, lon, height, datum)`). Get method: latlonheightdatum(self) - Get the lat-, longitude in `degrees` with height and datum (LatLon4Tuple`(lat, lon, height, datum)`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.

### latlonVermeille Get the latitude and Vermeille longitude in `degrees [-225..+225]` (LatLon2Tuple`(lat, lon)`). Get method: latlonVermeille(self) - Get the latitude and Vermeille longitude in `degrees [-225..+225]` (LatLon2Tuple`(lat, lon)`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value. See Also: Property `lonVermeille`.

### lonVermeille Get the longitude in `degrees [-225..+225]` after Vermeille (2004), p 95. Get method: lonVermeille(self) - Get the longitude in `degrees [-225..+225]` after Vermeille (2004), p 95. Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value. See Also: Property `lamVermeille`.

### phi Get the latitude in `radians` (`float`). Get method: phi(self) - Get the latitude in `radians` (`float`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.

### philam Get the lat-, longitude in `radians` (PhiLam2Tuple`(phi, lam)`). Get method: philam(self) - Get the lat-, longitude in `radians` (PhiLam2Tuple`(phi, lam)`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.

### philamheight Get the lat-, longitude in `radians` and height (PhiLam3Tuple`(phi, lam, height)`). Get method: philamheight(self) - Get the lat-, longitude in `radians` and height (PhiLam3Tuple`(phi, lam, height)`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.

### philamheightdatum Get the lat-, longitude in `radians` with height and datum (PhiLam4Tuple`(phi, lam, height, datum)`). Get method: philamheightdatum(self) - Get the lat-, longitude in `radians` with height and datum (PhiLam4Tuple`(phi, lam, height, datum)`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.

### philamVermeille Get the latitude and Vermeille longitude in `radians [-PI*3/2..+PI*3/2]` (PhiLam2Tuple`(phi, lam)`). Get method: philamVermeille(self) - Get the latitude and Vermeille longitude in `radians [-PI*3/2..+PI*3/2]` (PhiLam2Tuple`(phi, lam)`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value. See Also: Property `lamVermeille`.

### xyz Get the geocentric `(x, y, z)` coordinates (Vector3Tuple`(x, y, z)`). Get method: xyz(self) - Get the geocentric `(x, y, z)` coordinates (Vector3Tuple`(x, y, z)`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.

### xyzh Get the geocentric `(x, y, z)` coordinates and `height` (Vector4Tuple`(x, y, z, h)`) Get method: xyzh(self) - Get the geocentric `(x, y, z)` coordinates and `height` (Vector4Tuple`(x, y, z, h)`) Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.