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

Class CartesianBase

       object --+                
                |                
     named._Named --+            
                    |            
     named._NamedBase --+        
                        |        
vector3dBase.Vector3dBase --+    
                            |    
            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.
 
destinationXyz(self, delta, Cartesian=None, **Cartesian_kwds)
Calculate the destination using a local delta from this cartesian.
 
hartzell(self, los=None)
Compute the intersection of a Line-Of-Sight from this certesian Point-Of-View (pov) with this datum's ellipsoid surface.
 
height4(self, earth=None, normal=True, Cartesian=None, **Cartesian_kwds)
Compute the height of this cartesian above or below and the projection on this datum's ellipsoid surface.
 
to3llh(self, datum=None)
DEPRECATED, use property latlonheightdatum or latlonheight.
 
toDatum(self, datum2, datum=None)
Convert this cartesian from one datum to an other.
 
toEcef(self)
Convert this cartesian to geodetic (lat-/longitude) coordinates.
 
toLatLon(self, datum=None, height=None, LatLon=None, **LatLon_kwds)
Convert this cartesian to a geodetic (lat-/longitude) point.
 
toLocal(self, Xyz=None, ltp=None, **Xyz_kwds)
Convert this geocentric cartesian to local X, Y and Z.
 
toLtp(self, Ecef=None)
Return the local tangent plane (LTP) for this cartesian.
 
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: circum3, iscolinearWith, meeus2, nearestOn, parse, trilaterate2d2, trilaterate3d2

Inherited from vector3dBase.Vector3dBase: __abs__, __add__, __cmp__, __div__, __eq__, __ge__, __gt__, __le__, __lt__, __matmul__, __mul__, __ne__, __neg__, __pos__, __radd__, __rmatmul__, __rsub__, __sub__, __truediv__, angleTo, apply, cmp, cross, dividedBy, dot, equals, isconjugateTo, isequalTo, minus, negate, others, plus, rotate, rotateAround, sum, times, times_, to2ab, to2ll, to3xyz, unit

Inherited from named._NamedBase: __repr__, __str__, toRepr

Inherited from named._Named: _DOT_, attrs, classof, copy, rename, toStr2

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __setattr__, __sizeof__, __subclasshook__

Properties
  Ecef
Get the ECEF class (EcefKarney), lazily.
  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 vector3dBase.Vector3dBase: crosserrors, euclid, length, length2, x, x2y2z2, 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.

destinationXyz (self, delta, Cartesian=None, **Cartesian_kwds)

 

Calculate the destination using a local delta from this cartesian.

Arguments:
  • delta - Local delta to the destination (XyzLocal, Enu, Ned or Local9Tuple).
  • Cartesian - Optional (geocentric) class to return the destination or None.
  • Cartesian_kwds - Optional, additional Cartesian keyword arguments, ignored if Cartesian is None.
Returns:
Destination as a Cartesian(x, y, z, **Cartesian_kwds) instance or if Cartesian is None, an Ecef9Tuple(x, y, z, lat, lon, height, C, M, datum) with M=None always.
Raises:
  • TypeError - Invalid delta, Cartesian or Cartesian_kwds.

hartzell (self, los=None)

 

Compute the intersection of a Line-Of-Sight from this certesian Point-Of-View (pov) with this datum's ellipsoid surface.

Arguments:
  • los - Line-Of-Sight, direction to earth (Vector3d) or None to point to the ellipsoid's center.
Returns:
The ellipsoid intersection (Cartesian).
Raises:
  • IntersectionError - Null pov or los vector, this pov is inside the ellipsoid or los points outside the ellipsoid or in an opposite direction.
  • TypeError - Invalid los or no datum.

See Also: Function hartzell for further details.

height4 (self, earth=None, normal=True, Cartesian=None, **Cartesian_kwds)

 

Compute the height of this cartesian above or below and the projection on this datum's ellipsoid surface.

Arguments:
  • earth - A datum, ellipsoid or earth radius overriding this datum (Datum, Ellipsoid, Ellipsoid2, a_f2Tuple or meter, conventionally).
  • normal - If True the projection is the nearest point on the ellipsoid's surface, otherwise the intersection of the radial line to the center and the ellipsoid's surface.
  • Cartesian - Optional class to return the height and projection (Cartesian) or None.
  • Cartesian_kwds - Optional, additional Cartesian keyword arguments, ignored if Cartesian is None.
Returns:
An instance of Cartesian or if Cartesian is None, a Vector4Tuple(x, y, z, h) with the projection x, y and z coordinates and height h in meter, conventionally.
Raises:
  • TypeError - Invalid earth.

Note: Use keyword argument height=0 to override Cartesian.height to {0} or any other scalar, conventionally in meter.

See Also: Ellipsoid.height4 for more information.

to3llh (self, datum=None)

 

DEPRECATED, use property latlonheightdatum or latlonheight.

Returns:
A LatLon4Tuple(lat, lon, height, datum).
Decorators:
  • @deprecated_method

Note: This method returns a -4Tuple and not a -3Tuple as its name may suggest.

toDatum (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.

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, height=None, LatLon=None, **LatLon_kwds)

 

Convert this cartesian to a geodetic (lat-/longitude) point.

Arguments:
  • datum - Optional datum (Datum, Ellipsoid, Ellipsoid2 or a_f2Tuple).
  • height - Optional height, overriding the converted height (meter), iff LatLon is not None.
  • LatLon - Optional class to return the geodetic point (LatLon) or None.
  • LatLon_kwds - Optional, additional LatLon keyword arguments, ignored if LatLon is 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.

toLocal (self, Xyz=None, ltp=None, **Xyz_kwds)

 

Convert this geocentric cartesian to local X, Y and Z.

Arguments:
  • Xyz - Optional class to return X, Y and Z (XyzLocal, Enu, Ned) or None.
  • ltp - The local tangent plane (LTP) to use, overriding this cartesian's LTP (Ltp).
  • 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.

toLtp (self, Ecef=None)

 

Return the local tangent plane (LTP) for this cartesian.

Arguments:
  • Ecef - Optional ECEF class (EcefKarney, ... EcefYou), overriding this cartesian's Ecef.

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 is 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).
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 is 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), lazily.

Get method:
Ecef(self) - Get the ECEF class (EcefKarney), lazily.
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

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:
height(self, height) - Set the height.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

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:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

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:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

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:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

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:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

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:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

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:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

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:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

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:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.