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

Class CartesianBase

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

(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:
Raises:
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:

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:
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.