Description
Translates the position vector from this
system into the output system.
Syntax
| [Visual Basic .NET] |
|---|
Public Function Transform( _
ByVal Epoch As System.Object, _
ByVal OutputSystem As IAgCrdnSystem, _
ByVal PositionInMySystem As IAgCartesian3Vector _
) As IAgCrdnSystemTransformResult
|
| [C#] |
|---|
public IAgCrdnSystemTransformResult Transform(
|
| [Managed C++] |
|---|
public: IAgCrdnSystemTransformResult^ Transform(
|
| [Java] |
|---|
public IAgCrdnSystemTransformResult transform(
|
| [Unmanaged C++] |
|---|
public: HRESULT Transform(
|
Parameters
- Epoch
- Specify an epoch. The method may throw an exception if the epoch parameter specified cannot be converted to a currently selected date unit.
- OutputSystem
- Specify a system to transform the position to.
- PositionInMySystem
- A position vector to be transformed from this system to the output system.
Remarks
Consider a point moving along its trajectory
in space. The point's position and velocity can be given at some
specified time using Cartesian coordinates in one of VGT coordinate
systems. The same point at the same time will have different
Cartesian coordinates with respect to a different VGT coordinate
system. One set of coordinates can be obtained from the other using
Transform methods defined for VGT coordinate systems: given time
and coordinates with respect to one VGT coordinate system, these
methods output coordinates with respect to another system. For
example, consider a center point of a satellite. Its location in
low Earth orbit can be given using Cartesian coordinates with
respect to the ECEF coordinate system ("ECEF" means "Earth Centered
Earth Fixed"). The same location is significantly farther away from
the center of the Moon so its Cartesian coordinates in the Moon
Centered Moon Fixed coordinate system will reflect a much greater
distance from the Moon center.