Description | Example | Return message | Group

AddAttitude CBFQuat

Adds attitude data based on a time-ordered set of quaternions interpreted relative to CBF

Syntax

AddAttitude <ObjectPath> CBFQuat {StartTime} <Q1> <Q2> <Q3> <Q4>

Description

Use this command to modify the attitude of a vehicle by passing attitude quaternion data to STK. The reference coordinate axes are central body fixed (CBF). <Q1> through <Q4> are components of a quaternion, where <Q1> through <Q3> specify a vector part (eigen-axis) and <Q4> specifies a scalar part (eigen-angle).

For valid {StartTime} values see Time Options.

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

The method used by this command converts to CBI and then interpolates, in contrast to the preferred method used in the SetAttitude DataReference command (using the CBFixed attitude profile), which interpolates in CBF space and then converts to CBI.

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

Examples

To use CBF-based quaternions to define a missile's attitude at a specified time:

AddAttitude */Missile/Missile1 CBFQuat "1 Jun 2002 12:01:00.00" 0.0 0.0 0.0 1.0

Return message

If activated, Connect returns an acknowledgment message.

Group membership

This command belongs to the following group(s):

Vehicles

Version

10