Description | Example | Return Message | Group

AddAttitude YPR

Adds attitude data based on a time-ordered set of yaw, pitch and roll angles

Syntax

AddAttitude <ObjectPath> YPR {StartTime} {Sequence} <Yaw> <Pitch> <Roll>

Description

Use the AddAttitude YPR command to modify the attitude of a vehicle using yaw, pitch and roll attitude data.

The {Sequence} parameter identifies the order of rotations where the numbers 1, 2 and 3 correspond to the rotations about the ECI VVLH coordinate system X, Y and Z axes, respectively. A rotation about the Z axis is considered to be yaw, about the Y axis is pitch and about the X axis is roll. Valid values for {Sequence} are 123, 132, 213, 231, 312, 321.

The angle values, <Yaw> <Pitch> <Roll>, are entered in degrees.

For valid {StartTime} values see Time Options.

The AddAttitude YPR command is similar to using an external attitude profile, except that the points are entered one at a time using this command.

Note: The AddAttitude YPR command will use it's default frame (CBIVVLH) and will ignore any reference frame set with the SetAttitude DataReference command.

Warning: Multiple inputs of attitude data must be entered with increasing times. If you attempt to enter altitude data that is dated prior to existing attitude data, the new entry is ignored. To clear old data, use the SetAttitude ClearData command.

Example

To add a new line to the STK1 satellite's default attitude file in the Test scenario:

AddAttitude */Satellite/STK1 YPR "1 Nov 2000 04:01:00.00" 321 15.0 30.0 45.0

ReturnMessage

If activated, Connect returns an acknowledgment message.

Group Membership

This command belongs to the following group(s):

Vehicles

Version

10

STK Programming Interface 11.0.1