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

# Class CartesianBase

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

Known Subclasses:
  - ellipsoidalKarney.Cartesian
  - , ellipsoidalNvector.Cartesian
  - , ellipsoidalVincenty.Cartesian

(INTERNAL) Base class for ellipsoidal `Cartesian`.

Instance Methods
convertDatum(self, datum2, datum) Convert this Cartesian point from one to an other datum. |
convertRefFrame(self, reframe2, reframe, epoch=None) Convert this Cartesian point from one to an other reference frame. |
to3llh(self, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran`...`) Convert this (geocentric) Cartesian (x/y/z) point to (ellipsoidal, geodetic) lat-, longitude and height on the given datum. |
toStr(self, prec=3, fmt=`'``[%s]``'`, sep=`'``,` `'`) Return the string representation of this cartesian. |
Inherited from `vector3d.Vector3d`: `__abs__`, `__add__`, `__cmp__`, `__div__`, `__eq__`, `__ge__`, `__gt__`, `__iadd__`, `__imatmul__`, `__imul__`, `__init__`, `__isub__`, `__itruediv__`, `__le__`, `__lt__`, `__matmul__`, `__mul__`, `__ne__`, `__neg__`, `__pos__`, `__radd__`, `__rmatmul__`, `__rmul__`, `__rsub__`, `__sub__`, `__truediv__`, `angleTo`, `copy`, `cross`, `dividedBy`, `dot`, `equals`, `isequalTo`, `minus`, `negate`, `others`, `parse`, `plus`, `rotate`, `rotateAround`, `sum`, `times`, `to2ab`, `to2ll`, `to3xyz`, `unit` Inherited from `named._NamedBase`: `__repr__`, `__str__`, `toStr2` Inherited from `named._Named`: `__copy__`, `classof` Inherited from `object`: `__delattr__`, `__format__`, `__getattribute__`, `__hash__`, `__new__`, `__reduce__`, `__reduce_ex__`, `__setattr__`, `__sizeof__`, `__subclasshook__`

Properties
Inherited from `vector3d.Vector3d`: `crosserrors`, `length`, `x`, `y`, `z` Inherited from `named._Named`: `classname`, `classnaming`, `name`, `named`, `named2` Inherited from `object`: `__class__`

Method Details

### convertDatum(self, datum2, datum) |
Convert this Cartesian point from one to an other datum. Parameters: `datum2` - Datum to convert to (Datum). `datum` - Datum to convert from (Datum). Returns: The converted Cartesian point (`Cartesian`). Raises: `TypeError` - `datum2` or `datum` not a Datum.

### convertRefFrame(self, reframe2, reframe, epoch=None) |
Convert this Cartesian point from one to an other reference frame. Parameters: `reframe2` - Reference frame to convert to (RefFrame). `reframe` - Reference frame to convert from (RefFrame). `epoch` - Optional epoch to observe for `reframe`, a fractional calendar year (`scalar`). Returns: The converted Cartesian point (`Cartesian`) or this Cartesian point if conversion is `nil`. Raises: `TRFError` - No conversion available from `reframe` to `reframe2`. `TypeError` - `reframe2` or `reframe` not a RefFrame or `epoch` not `scalar`.

### to3llh(self, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran`...`) |
Convert this (geocentric) Cartesian (x/y/z) point to (ellipsoidal, geodetic) lat-, longitude and height on the given datum. Uses B. R. Bowring’s formulation for μm precision in concise form: 'The accuracy of geodetic latitude and height equations', Survey Review, Vol 28, 218, Oct 1985. See also Ralph M. Toms 'An Efficient Algorithm for Geocentric to Geodetic Coordinate Conversion', Sept 1995 and 'An Improved Algorithm for Geocentric to Geodetic Coordinate Conversion', Apr 1996, from Lawrence Livermore National Laboratory. Parameters: `datum` - Optional datum to use (Datum). Returns: A LatLon3Tuple`(lat, lon, height)`.

### toStr(self, prec=3, fmt=`'``[%s]``'`, sep=`'``,` `'`) |
Return the string representation of this cartesian. Parameters: `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). Overrides: named._NamedBase.toStr