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.

Note: 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.

Hint: 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>}

Example

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

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Vehicles

Version

10

STK Programming Interface 11.0.1