STK Vector Geometry Tool	Send comments on this topic.
CreateTopocentricAxesQuaternion Method (IAgCrdnAxesCommonTasks)
See Also

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.

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

[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 );

[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 );

[Managed C++]

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 ** ppRetVal );

[Unmanaged C++]

public: HRESULT CreateTopocentricAxesQuaternion(
    IAgCrdnPoint * OriginPoint,
    double QX,
    double QY,
    double QZ,
    double QS,
    IAgCrdnAxesFixed ** ppRetVal
);

[Java]
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
);

[Python - STK API ]
def CreateTopocentricAxesQuaternion(self, OriginPoint:"IAgCrdnPoint", QX:float, QY:float, QZ:float, QS:float) -> "IAgCrdnAxesFixed":

[Python - STK API

]

def CreateTopocentricAxesQuaternion(self, OriginPoint:"IAgCrdnPoint", QX:float, QY:float, QZ:float, QS:float) -> "IAgCrdnAxesFixed":

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