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

Class CartesianBase

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

(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