AGI STK VGT 11Send comments on this topic.
CreateTopocentricAxesQuaternion Method (IAgCrdnAxesCommonTasks)
See Also  Example
OriginPoint
Specify an origin point of the axes on the surface of a central body.
QX
The first element of the vector component of the quaternion representing orientation between two sets of axes. This quaternion is from the reference axes to the body frame; if n and A are the axis and angle of rotation, respectively, then QX = nx sin(A/2). Dimensionless.
QY
The second element of the vector component of the quaternion representing orientation between two sets of axes. This quaternion is from the reference axes to the body frame; if n and A are the axis and angle of rotation, respectively, then QY = ny sin(A/2). Dimensionless.
QZ
The third element of the vector component of the quaternion representing orientation between two sets of axes. This quaternion is from the reference axes to the body frame; if n and A are the axis and angle of rotation, respectively, then QZ = nz sin(A/2). Dimensionless.
QS
The scalar component of the quaternion representing orientation between two sets of axes. This quaternion is from the reference axes to the body frame; if n and A are the axis and angle of rotation, respectively, then QS = cos(A/2). Dimensionless.
Windows






Windows & Linux

Description

Creates non-persistent axes fixed in axes on the surface of a central body with the location specified by the origin point. The quaternion defines the axes's orientation.

Syntax

[Visual Basic .NET]
Public Function CreateTopocentricAxesQuaternion( _
   ByVal OriginPoint As IAgCrdnPoint, _
   ByVal QX As Double, _
   ByVal QY As Double, _
   ByVal QZ As Double, _
   ByVal QS As Double _
) As IAgCrdnAxesFixed
[C#]
public IAgCrdnAxesFixed CreateTopocentricAxesQuaternion(
   IAgCrdnPoint OriginPoint, 
   double QX, 
   double QY, 
   double QZ, 
   double QS
);
[Managed C++]
public: IAgCrdnAxesFixed^ CreateTopocentricAxesQuaternion(
   IAgCrdnPoint ^ OriginPoint, 
   double QX, 
   double QY, 
   double QZ, 
   double QS
);
[Java]
public IAgCrdnAxesFixed createTopocentricAxesQuaternion(
   IAgCrdnPoint OriginPoint, 
   double QX, 
   double QY, 
   double QZ, 
   double QS
);
[Unmanaged C++]
public: HRESULT CreateTopocentricAxesQuaternion(
   IAgCrdnPoint * OriginPoint, 
   double QX, 
   double QY, 
   double QZ, 
   double QS, 
   IAgCrdnAxesFixed ** ReturnValue
);

Parameters

OriginPoint
Specify an origin point of the axes on the surface of a central body.
QX
The first element of the vector component of the quaternion representing orientation between two sets of axes. This quaternion is from the reference axes to the body frame; if n and A are the axis and angle of rotation, respectively, then QX = nx sin(A/2). Dimensionless.
QY
The second element of the vector component of the quaternion representing orientation between two sets of axes. This quaternion is from the reference axes to the body frame; if n and A are the axis and angle of rotation, respectively, then QY = ny sin(A/2). Dimensionless.
QZ
The third element of the vector component of the quaternion representing orientation between two sets of axes. This quaternion is from the reference axes to the body frame; if n and A are the axis and angle of rotation, respectively, then QZ = nz sin(A/2). Dimensionless.
QS
The scalar component of the quaternion representing orientation between two sets of axes. This quaternion is from the reference axes to the body frame; if n and A are the axis and angle of rotation, respectively, then QS = cos(A/2). Dimensionless.

Example

Creates a fixed axes based on the origin point with Quaternion orientation (using common tasks).
[C#]Copy Code
object lat = 0, lon = 0; 
double alt = 0; 
 
facility.Position.QueryPlanetodetic(out lat, out lon, out alt); 
IAgCrdnPointFixedInSystem origin = provider.Points.CommonTasks.CreateFixedInSystemCartographic(provider.Systems["Fixed"], lat, lon, alt); 
IAgCrdnAxesFixed eastNorthUp = provider.Axes.CommonTasks.CreateTopocentricAxesQuaternion((IAgCrdnPoint)origin, 0.0, 0.0, 0.0, 1.0); 
 

Creates a fixed axes based on the origin point with Quaternion orientation (using common tasks).
[Visual Basic .NET]Copy Code
Dim lat As Object = 0, lon As Object = 0
Dim alt As Double = 0

facility.Position.QueryPlanetodetic(lat, lon, alt)
Dim origin As IAgCrdnPointFixedInSystem = provider.Points.CommonTasks.CreateFixedInSystemCartographic(provider.Systems("Fixed"), lat, lon, alt)
Dim eastNorthUp As IAgCrdnAxesFixed = provider.Axes.CommonTasks.CreateTopocentricAxesQuaternion(DirectCast(origin, IAgCrdnPoint), 0, 0, 0, 1)

See Also

© 2019 Analytical Graphics, Inc. All Rights Reserved.