Description | Example | Return message | GroupAddAttitudeProfile

AddAttitude Profile

Add further attitude profiles to a single object

Syntax

AddAttitude <ObjectPath> Profile [<ProfileName>] {StartTime} {ProfileType} <Parameters>

Related commands

Description

Use the AddAttitude Profile command to add an additional profile for orienting a single vehicle. Profiles are ordered by {StartTime}. The optional <ProfileName> parameter allows you to specify the name of the attitude profile.

For valid {StartTime} values see Time Options.

The command will nack if the start time entered is the duplicate of an existing profile's start time.

There will always be at least one attitude profile already existing for a vehicle. This attitude profile's start time will match the scenario start time. To change this profile use the AttitudeSegment Modify Profile command.

For further information on available {ProfileTypes} and <Parameters>, see the SetAttitude Profile Connect command.

In addition to the profiles described in the SetAttitude Profile Connect command, the FixedTimeSlew and VariableTimeSlew {ProfileTypes} are also available when adding attitude profiles to an existing vehicle.

<Parameters> for FixedTimeSlew {ProfileType} are described in the following table.

FixedTimeSlew <Parameters>Description
Smooth {On | Off}Specify whether to take account of the angular velocity (slope) at the beginning and end of the slew.

<Parameters> for VariableTimeSlew {ProfileType} are described in the following table. Any number of <Parameters> may be entered on one command.

VariableTimeSlew <Parameters>Description
Mode {FixedRate | Constrained}Set the value for slew mode. The default value is FixedRate.

If Constrained is entered the SlewType will be set to 2ndOrderSpline.

SlewSegmentTiming {Earliest | Latest | Optimal}Specify when to execute the slew within the window of opportunity. The default value is Earliest.
SlewType {2ndOrderSpline | 3rdOrderSpline}Set the type of the Constrained slew mode. This option will set the Mode to Constrained, if necessary.
RateMagnitude <Value>Set the maximum slew rate. The <Value> must be between 0.0 deg/sec and 1000 deg/sec. The default value is 50 deg/sec.
RateAxisX {On | Off | <Value>}Turn on or off, or set values for the maximum slew rate axis constraints.

If the <Value> is entered the constraint will be also be turned On. Enter the <Value> in degrees/second. The <Value> must be between 0.0 deg/sec and 1000 deg/sec. The default value is for all RateAxis entries is 30 deg/sec.

RateAxisY {On | Off | <Value>}
RateAxisZ {On | Off | <Value>}
AccelMagnitude <Value>Set the maximum slew acceleration. The <Value> must be between 0.0 deg/sec^2 and 1000 deg/sec^2. The default value is 5 deg/sec^2.

This option is used when slew Mode is Constrained.

AccelAxisX {On | Off | <Value>}Turn on or off, or set values for the maximum slew acceleration axis constraints.

If the <Value> is entered the constraint will be also be turned On. Enter the <Value> in degrees/second^2. The <Value> must be between 0.0 deg/sec^2 and 1000 deg/sec^2. The default value is for all RateAxis entries is 3 deg/sec^2

These constraints are used when slew Mode is Constrained.

AccelAxisY {On | Off | <Value>}
AccelAxisZ {On | Off | <Value>}

Examples

To Add a FixedTimeSlew profile to Satellite1:

AddAttitude */Satellite/Satellite1 Profile "1 Jun 2003 01:00:00.00" FixedTimeSlew Smooth On

To Add an InertFix profile, named MyInertial, to Satellite1:

AddAttitude */Satellite/Satellite1 Profile MyInertial "1 Jun 2003 02:00:00.00" InertFix Euler 10.0 20.0 30.0 321

Return message

Group membership

This command belongs to the following group(s):

Vehicles

Version

10