Package pygeodesy :: Module cartesianBase :: Class CartesianBase |
[frames] | no frames]

# Class CartesianBase

      object --+
               |
    named._Named --+
                   |
    named._NamedBase --+
                       |
       vector3d.Vector3d --+
                           |
                          CartesianBase

Known Subclasses:
  - ellipsoidalBase.CartesianEllipsoidalBase
  - , sphericalBase.CartesianSphericalBase

(INTERNAL) Base class for ellipsoidal and spherical `Cartesian`.

Instance Methods
__init__(self, xyz, y=None, z=None, datum=None, ll=None, name=`'````'`) New `Cartesian...`. |
convertDatum(self, datum2, datum=None) Convert this cartesian from one datum to an other. |
to3llh(self, datum=None) DEPRECATED, use property `latlonheightdatum` or property `latlonheight`. |
toEcef(self) Convert this cartesian to geodetic (lat-/longitude) coordinates. |
toLatLon(self, datum=None, LatLon=None, **LatLon_kwds) Convert this cartesian to a geodetic (lat-/longitude) point. |
toNvector(self, Nvector=None, datum=None, **Nvector_kwds) Convert this cartesian to `n-vector` components. |
toStr(self, prec=3, fmt=`'``[%s]``'`, sep=`'``,` `'`) Return the string representation of this cartesian. |
toVector(self, Vector=None, **Vector_kwds) Return this cartesian's components as vector. |
Inherited from `vector3d.Vector3d`: `__abs__`, `__add__`, `__cmp__`, `__div__`, `__eq__`, `__ge__`, `__gt__`, `__le__`, `__lt__`, `__matmul__`, `__mul__`, `__ne__`, `__neg__`, `__pos__`, `__radd__`, `__rmatmul__`, `__rsub__`, `__sub__`, `__truediv__`, `angleTo`, `cmp`, `cross`, `dividedBy`, `dot`, `equals`, `iscolinearWith`, `isequalTo`, `minus`, `nearestOn`, `negate`, `others`, `parse`, `plus`, `rotate`, `rotateAround`, `sum`, `times`, `to2ab`, `to2ll`, `to3xyz`, `trilaterate3d2`, `unit` Inherited from `named._NamedBase`: `__repr__`, `__str__`, `toRepr` Inherited from `named._Named`: `_dot_`, `attrs`, `classof`, `copy`, `toStr2` Inherited from `object`: `__delattr__`, `__format__`, `__getattribute__`, `__hash__`, `__new__`, `__reduce__`, `__reduce_ex__`, `__setattr__`, `__sizeof__`, `__subclasshook__`

Properties
| Ecef Get the ECEF class (EcefKarney or EcefVeness).
| datum Property to get and set this cartesian's datum (Datum).
| height Get the height (`meter`).
| isEllipsoidal Check whether this cartesian is ellipsoidal (`bool` or `None` if unknown).
| isSpherical Check whether this cartesian is spherical (`bool` or `None` if unknown).
| latlon Get this cartesian's (geodetic) lat- and longitude in `degrees` (LatLon2Tuple`(lat, lon)`).
| latlonheight Get this cartesian's (geodetic) lat-, longitude in `degrees` with height (LatLon3Tuple`(lat, lon, height)`).
| latlonheightdatum Get this cartesian's (geodetic) lat-, longitude in `degrees` with height and datum (LatLon4Tuple`(lat, lon, height, datum)`).
| philam Get this cartesian's (geodetic) lat- and longitude in `radians` (PhiLam2Tuple`(phi, lam)`).
| philamheight Get this cartesian's (geodetic) lat-, longitude in `radians` with height (PhiLam3Tuple`(phi, lam, height)`).
| philamheightdatum Get this cartesian's (geodetic) lat-, longitude in `radians` with height and datum (PhiLam4Tuple`(phi, lam, height, datum)`).
Inherited from `vector3d.Vector3d`: `crosserrors`, `euclid`, `length`, `length2`, `x`, `xyz`, `y`, `z` Inherited from `named._Named`: `classname`, `classnaming`, `name`, `named`, `named2`, `named3`, `named4` Inherited from `object`: `__class__`

Method Details

### __init__ (self, xyz, y=None, z=None, datum=None, ll=None, name=`'````'`) (Constructor) |
New `Cartesian...`. Arguments: `xyz` - An Ecef9Tuple, Vector3Tuple, Vector4Tuple or the `X` coordinate (`scalar`). `y` - The `Y` coordinate (`scalar`) if `xyz` `scalar`. `z` - The `Z` coordinate (`scalar`) if `xyz` `scalar`. `datum` - Optional datum (Datum, Ellipsoid, Ellipsoid2 or a_f2Tuple). `ll` - Optional, original latlon (`LatLon`). `name` - Optional name (`str`). Raises: `TypeError` - Non-scalar `xyz`, `y` or `z` coordinate or `xyz` not an Ecef9Tuple, Vector3Tuple or Vector4Tuple. Overrides: object.__init__

### convertDatum (self, datum2, datum=None) |
Convert this cartesian from one datum to an other. Arguments: `datum2` - Datum to convert to (Datum). `datum` - Datum to convert from (Datum). Returns: The converted point (`Cartesian`). Raises: `TypeError` - `datum2` or `datum` invalid.

### to3llh (self, datum=None) |
DEPRECATED, use property `latlonheightdatum` or property `latlonheight`. Returns: A LatLon4Tuple`(lat, lon, height, datum)`. Note: This method returns a `-4Tuple` and not a `-3Tuple` as its name suggests.

### toEcef (self) |
Convert this cartesian to geodetic (lat-/longitude) coordinates. Returns: An Ecef9Tuple`(x, y, z, lat, lon, height, C, M, datum)` with `C` and `M` if available. Raises: `EcefError` - A `.datum` or an ECEF issue.

### toLatLon (self, datum=None, LatLon=None, **LatLon_kwds) |
Convert this cartesian to a geodetic (lat-/longitude) point. Arguments: `datum` - Optional datum (Datum, Ellipsoid, Ellipsoid2 or a_f2Tuple). `LatLon` - Optional class to return the geodetic point (`LatLon`) or `None`. `LatLon_kwds` - Optional, additional `LatLon` keyword arguments, ignored if `LatLon=None`. Returns: The geodetic point (`LatLon`) or if `LatLon` is `None`, an Ecef9Tuple`(x, y, z, lat, lon, height, C, M, datum)` with `C` and `M` if available. Raises: `TypeError` - Invalid `datum` or `LatLon_kwds`.

### toNvector (self, Nvector=None, datum=None, **Nvector_kwds) |
Convert this cartesian to `n-vector` components. Arguments: `Nvector` - Optional class to return the `n-vector` components (`Nvector`) or `None`. `datum` - Optional datum (Datum, Ellipsoid, Ellipsoid2 or a_f2Tuple) overriding this cartesian's datum. `Nvector_kwds` - Optional, additional `Nvector` keyword arguments, ignored if `Nvector=None`. Returns: The `unit, n-vector` components (`Nvector`) or a Vector4Tuple`(x, y, z, h)` if `Nvector` is `None`. Raises: `TypeError` - Invalid `datum`. `ValueError` - The `Cartesian` at origin. Example:
    >>> c = Cartesian(3980581, 97, 4966825)
    >>> n = c.toNvector()  # (x=0.622818, y=0.00002, z=0.782367, h=0.242887)

### toStr (self, prec=3, fmt=`'``[%s]``'`, sep=`'``,` `'`) |
Return the string representation of this cartesian. Arguments: `prec` - Optional number of decimals, unstripped (`int`). `fmt` - Optional enclosing backets format (string). `sep` - Optional separator to join (string). Returns: Cartesian represented as "[x, y, z]" (string). Raises: `AssertionError` - Always, see function notOverloaded. Overrides: named._Named.toStr

### toVector (self, Vector=None, **Vector_kwds) |
Return this cartesian's components as vector. Arguments: `Vector` - Optional class to return the `n-vector` components (Vector3d) or `None`. `Vector_kwds` - Optional, additional `Vector` keyword arguments, ignored if `Vector=None`. Returns: A `Vector` or an Vector3Tuple`(x, y, z)` if `Vector` is `None`. Raises: `TypeError` - Invalid `Vector` or `Vector_kwds`.

Property Details

### Ecef Get the ECEF class (EcefKarney or EcefVeness). Get method: Ecef(self) - Get the ECEF class (EcefKarney or EcefVeness). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### datum Property to get and set this cartesian's datum (Datum). Get method: datum(self) - Get this cartesian's datum (Datum). Set method: datum(self, datum) - Set this cartesian's `datum` without conversion.

### height Get the height (`meter`). Get method: height(self) - Get the height (`meter`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### isEllipsoidal Check whether this cartesian is ellipsoidal (`bool` or `None` if unknown). Get method: isEllipsoidal(self) - Check whether this cartesian is ellipsoidal (`bool` or `None` if unknown). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### isSpherical Check whether this cartesian is spherical (`bool` or `None` if unknown). Get method: isSpherical(self) - Check whether this cartesian is spherical (`bool` or `None` if unknown). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### latlon Get this cartesian's (geodetic) lat- and longitude in `degrees` (LatLon2Tuple`(lat, lon)`). Get method: latlon(self) - Get this cartesian's (geodetic) lat- and longitude in `degrees` (LatLon2Tuple`(lat, lon)`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### latlonheight Get this cartesian's (geodetic) lat-, longitude in `degrees` with height (LatLon3Tuple`(lat, lon, height)`). Get method: latlonheight(self) - Get this cartesian's (geodetic) lat-, longitude in `degrees` with height (LatLon3Tuple`(lat, lon, height)`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### latlonheightdatum Get this cartesian's (geodetic) lat-, longitude in `degrees` with height and datum (LatLon4Tuple`(lat, lon, height, datum)`). Get method: latlonheightdatum(self) - Get this cartesian's (geodetic) lat-, longitude in `degrees` with height and datum (LatLon4Tuple`(lat, lon, height, datum)`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### philam Get this cartesian's (geodetic) lat- and longitude in `radians` (PhiLam2Tuple`(phi, lam)`). Get method: philam(self) - Get this cartesian's (geodetic) lat- and longitude in `radians` (PhiLam2Tuple`(phi, lam)`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### philamheight Get this cartesian's (geodetic) lat-, longitude in `radians` with height (PhiLam3Tuple`(phi, lam, height)`). Get method: philamheight(self) - Get this cartesian's (geodetic) lat-, longitude in `radians` with height (PhiLam3Tuple`(phi, lam, height)`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### philamheightdatum Get this cartesian's (geodetic) lat-, longitude in `radians` with height and datum (PhiLam4Tuple`(phi, lam, height, datum)`). Get method: philamheightdatum(self) - Get this cartesian's (geodetic) lat-, longitude in `radians` with height and datum (PhiLam4Tuple`(phi, lam, height, datum)`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.