Package pygeodesy :: Module trf :: Class TRFXform
[frames] | no frames]

Class TRFXform

  object --+    
           |    
named._Named --+
               |
              TRFXform

Terrestrial Reference Frame (TRF) converter between two reference frames observed at an epoch.

Instance Methods
 
__init__(self, refName1, refName2, epoch=None, xform=None, rates=None, name='')
New trfXform.
 
__lt__(self, other)
 
__neg__(self)
 
__repr__(self)
Default repr(self).
 
inverse(self, name='')
Return the inverse of this Xform.
 
toEpoch(self, epoch)
Convert this Xform to epoch, if needed.
 
toRefFrame(self, point, epoch=None, datum=Datum(name='GRS80', ellipsoid=Ellipsoids.GRS80, transform=Tran..., **epoch2_name)
Convert a cartesian or geodetic point using this Xform's refName1, refName2, epoch and Transform.
 
toRepr(self, **unused)
Return the represention of this Xform (str).
 
toStr(self, epoch=None, **unused)
Return this Xform as "fromRef@epoch_toRef" (str).
 
toTransform(self, epoch1, epoch2=None, inverse=False)
Combine this Xform observed at epoch1 into a Helmert TransformXform, optionally at epoch2 or epoch1.

Inherited from named._Named: __imatmul__, __matmul__, __rmatmul__, __str__, attrs, classof, copy, dup, methodname, rename, toStr2

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

Class Variables
  epoch = epoch (0)
  refName2 = ''
  refName1 = ''
  xform = TRFXform7Tuple(tx=0.0, ty=0.0, tz=0.0, s=0.0, sx=0.0, ...
  rates = TRFXform7Tuple(tx=0.0, ty=0.0, tz=0.0, s=0.0, sx=0.0, ...
Properties

Inherited from named._Named: classname, classnaming, iteration, name, named, named2, named3, named4, sizeof

Inherited from object: __class__

Method Details

__init__ (self, refName1, refName2, epoch=None, xform=None, rates=None, name='')
(Constructor)

 

New trfXform.

Arguments:
  • refName1 - Source reframe (str), converting from.
  • refName2 - Destination reframe (str), converting to.
  • epoch - Epoch, a fractional year (Epoch, scalar or str).
  • xform - Transform parameters (TRFXform7Tuple).
  • rates - Rate parameters (TRFXform7Tuple), as xform, but in units-per-year.
  • name - Optional name (str)
Returns:
The new TRF converter (TRFXform).
Raises:
  • TRFError - Invalid epoch, xform or rates.
Overrides: object.__init__

__repr__ (self)
(Representation operator)

 

Default repr(self).

Overrides: object.__repr__
(inherited documentation)

inverse (self, name='')

 

Return the inverse of this Xform.

Arguments:
  • name - Optional name (str).
Returns:
Inverse (TRFXform).

toEpoch (self, epoch)

 

Convert this Xform to epoch, if needed.

Arguments:
  • epoch - Epoch, fractional year (Epoch, scalar or str).
Returns:
This Xform or a copy converted to epoch.
Raises:

toRefFrame (self, point, epoch=None, datum=Datum(name='GRS80', ellipsoid=Ellipsoids.GRS80, transform=Tran..., **epoch2_name)

 

Convert a cartesian or geodetic point using this Xform's refName1, refName2, epoch and Transform.

Arguments:
  • epoch - Optional epoch ((Epoch, scalar or str)), overriding this transform's Xform's epoch.
Returns:
A copy of the point, converted or renamed.

See Also: Method RefFrame.toRefFrame for more details.

toRepr (self, **unused)

 

Return the represention of this Xform (str).

Overrides: named._Named.toRepr

toStr (self, epoch=None, **unused)

 

Return this Xform as "fromRef@epoch_toRef" (str).

Arguments:
  • epoch - Epoch (scalar), overriding this Xform's epoch.
Overrides: named._Named.toStr

toTransform (self, epoch1, epoch2=None, inverse=False)

 

Combine this Xform observed at epoch1 into a Helmert TransformXform, optionally at epoch2 or epoch1.

Arguments:
  • epoch1 - Epoch to observe from (scalar).
  • epoch2 - Optional epoch to observe to (scalar).
  • inverse - Invert the Helmert tranformation (bool).
Raises:

Note: Translations are converted from milli-meter to meter, shift rates from milli-arc-seconds to arc-seconds and scale from ppb to ppM.


Class Variable Details

xform

Value:
TRFXform7Tuple(tx=0.0, ty=0.0, tz=0.0, s=0.0, sx=0.0, sy=0.0, sz=0.0)

rates

Value:
TRFXform7Tuple(tx=0.0, ty=0.0, tz=0.0, s=0.0, sx=0.0, sy=0.0, sz=0.0)