Point FixedInRef
Control fixed sensor pointing for a specified sensor instance.
Syntax
Point <SensorObjectPath> FixedInRef {OrientMethod} <MethodData> "<ReferenceAxes>"
Related commands
- Point 3DModel
- Point AlongVector
- Point External
- Point Fixed
- Point GrazingAlt
- Point Schedule
- Point Spinning
- Point Targeted
Description
The Point FixedInRef command controls sensor pointing for fixed-in-reference axes for a specified sensor instance. FixedInRef sensor pointing enables you to specify the orientation of the sensor and reference axes.
When specifying the "<ReferenceAxes>" of an object, include the truncated path of the object followed by a space and the name of the axes, all in quotes. For example: "Satellite/attSat VNC".
When specifying the "<ReferenceAxes>" of a central body, include the truncated path of the central body followed by a space and the name of the axes, all in quotes. For example: "CentralBody/Earth Inertial"
<MethodData> for FixedInRef sensor pointing is dependent on the {OrientMethod} used. Valid values for {OrientMethod} <MethodData> are described in the following table.
{{UseRefAxesFlippedAboutX}] for FixedInRef sensor pointing may only be specified for sensors attached to Facility, Place, or Target objects. It governs whether the specified reference axes are flipped by 180 degrees about its X-axis when setting the sensor's body axes frame. Valid values are True, Yes, False, and No. The default is False.
| {OrientMethod} | <MethodData> | Description |
|---|---|---|
| AzEl | <Azimuth> <Elevation> [{AboutBoresight}] | {AboutBoresight} can be Hold or Rotate. |
| Euler | <Sequence> <Rot1> <Rot2> <Rot3> | <Sequence> can be 121, 123, 131, 132, 212, 213, 231, 232, 312, 313, 321, 323, where 1 is the rotation about the Z axis, 2 is the rotation about the Y axis and 3 is the rotation about the Z axis. |
| YPR | <Sequence> <Yaw> <Pitch> <Roll> | <Sequence> can be 123, 132, 213, 231, 312, or 321, where 1 is the rotation about the reference X axis, 2 is the rotation about the reference Y axis, and 3 is the rotation about the reference Z axis. The reference axes are the body-fixed axes of the parent object.
Similarly to Euler angles, YPR angles specify attitude using three rotations in a chosen sequence: the rotation about the reference X axis is called roll (R), the rotation about the reference Y axis is called pitch (P), and the rotation about the reference Z axis is called yaw (Y). Sequences are identified using either numbers (1 is the X axis, 2 is the Y axis, 3 is the Z axis) or letters (R is the X axis, P is the Y axis, Y is the Z axis). Unlike Euler angles, the rotations are not made about axes defined by an earlier rotation. Instead, each rotation is made about the reference system's axes. In YPR angles, the names yaw, pitch, and roll do NOT refer to the angles normally used in aviation; the terms yaw, pitch, and roll in aviation refer to 321 Euler angles. |
| Quaternion | <q1> <q2> <q3> <q4> | N/A |
All angle values should be entered in degrees.
Examples
To set the sensor's pointing to use YPR orientation and use them Satellite's Body axes as reference:
To set the sensor's pointing to use Quaternion orientation and use the Earth's Fixed axes as reference:
To set the sensor's pointing to use AzEl orientation and use the Facility's Body axes, flipped by 180 degrees about its X-axis as reference:
To set the sensor's pointing to use Euler orientation and use the Facility's Body axes as reference:
Return message
Group membership
This command belongs to the following group(s):
Version
4.3