SetAttitude Target
Reset attitude to use a targeted type
Syntax
SetAttitude <VehicleObjectPath> Target {TargetOption} [<Parameters>]
Related commands
Description
Use the SetAttitude Target command to point a vehicle at selected targets so that the vehicle's Z axis points in the direction of the target when the target is visible to the vehicle.
This command is valid for Satellites, LaunchVehicles, and Missiles.
Valid Target objects are all types of vehicles, facilities, places, targets, planets and stars. A target can also be a specified using a Latitude, Longitude and Altitude. In the descriptions below {TargetSpec} can be either:
- <TruncObjectPath>
- <Latitude> <Longitude> <Altitude>
A target specified using a Latitude, Longitude and Altitude will show in the Attitude MultiSegment UI, but it can only be created or modified via Connect.
{TargetOption} can be:
| {TargetOption} | <Value> | Description |
|---|---|---|
| {On | Off} | N/A | If On, targeted attitude will be used. |
| Add | {TargetSpec} | Specify the path of the target object. |
| Remove | ||
| Clear | N/A | Remove all targets. |
| Slew | {SlewOptions} | Set options for targeting slew. See table below for description of {SlewOptions}.
Targeted Attitude must be turned On and at least one Target specified before setting the Slew options. |
| BodyVectors | {TargetSpec} {AlignType} <Parameters> {ConstrType} <Parameters> [{UseDefault | "<ConstraintVector>"}] | Change the default selection of body vectors used in targeted attitude definitions, by specifying parameters for the aligned vector and parameters for the constrained vector. See table below for a description of the Type and Parameter values.
Optionally, the reference constraint vector can be set to either UseDefault or to a specific vector. |
| ReferenceConstraintVector | {TargetSpec} {UseDefault | "<ConstraintVector>"} | Set the reference constraint vector to either UseDefault or to a specific vector for the specified target. |
| Times | {TimeOption} <Parameters> | {TimeOptions} are outlined in the Table following. |
| ComputeOptions | {ComputeOption} | Set user controls for the Access computations. For a description of individual {ComputeOption} refer to the Table following. |
To specify the "<ConstraintVector>" the format is:
"<TruncObjectPath> <CrdnName> Vector"
For example: to specify the Moon vector for the satellite MultSelTest: "Satellite/MultSelTest Moon Vector", to specify the Orbit Normal vector for Earth: "CentralBody/Earth Orbit_Normal Vector"
If {TargetOption} is BodyVectors, {Type} and <Parameters> can be:
| {Type} | <Parameters> |
|---|---|
| PR | <Pitch> <Roll> |
| Euler | <Angle1> <Angle2> <Sequence>
Sequence can be 12, 21, 31, or 32 |
| RaDec | <RAAN> <Declination> |
| Axis | <X> <Y> <Z> |
If {TargetOption} is Times, {TimeOption} and <Parameters> can be:
| {TimeOption} | <Parameters> | Description |
|---|---|---|
| UseAccess | {On | Off | Off Clear | Off Copy} | If On, attitude targeting is based on accesses. If Off, the user-defined targeting schedule is used, no change is made to the existing targeting schedule. If Off Clear, the user-defined targeting schedule is used, and any existing intervals in the targeting schedule are cleared. If Off Copy, the user-defined targeting schedule is used, the targeting schedule is cleared and access times are copied to the targeting schedule list. |
| Add | {TargetSpec} "<StartTime>" "<StopTime>" | Add or remove an interval to/from the targeting schedule. |
| Remove | ||
| Change | {TargetSpec} "<ExistingStartTime>" "<ExistingStopTime>" "<NewStartTime>" "<NewStopTime>" | Change a given interval in the targeting schedule. |
| Replace | {TargetSpec} <NumIntervalPairs> "<StartTime1>" "<StopTime1>" ["<StartTime1>" "<StopTime1>"...] | Replaces the entire targeting schedule for the specified object with the schedule specified |
| Load | "<IntervalFile>" | Load time intervals from an STK interval file. For help on creating the STK interval file, see Create & Import External Files - Interval List in STK Help.
"<IntervalFile>" can be the path to a file on your local drive or the path to a file on an SDF server. See Specifying Paths for "<SDFFilePath>" syntax information. |
| Import | {TargetSpec} "<TimeComponent>" | Import the specified Interval or Interval List time component. The interval(s) from the specified component will be added to the targeting schedule.
For information about "<TimeComponent>" see Component Specification. |
| AutoDeconflict | N/A | Resolve any conflicts that exist between targets and times |
If {TimeOption} is Add, Remove, Change or Replace, and the UseAccess option is On, the UseAccess option is turned Off.
If {TargetOption} is ComputeOptions, {ComputeOption} can be:
| {ComputeOptions} | Description |
|---|---|
| UseLightTimeDelay {On | Off} | Choose whether to consider light time delay in access computations. When light time delay is not considered, aberration is ignored also. |
| LightTimeDelayConvergence <Value> | This option sets the tolerance used when iterating to determine the light time delay. <Value> is entered in Connect time units, and should be between 1.0e-9 to 0.1 seconds |
| AberrationType {Total | Annual | None} | Set the model of aberration to be used in access computations. |
| MinTimeStep <Value> | <Value> is entered in Connect time units, and should be between 1.0e-5 to 315576000.0 seconds |
| MaxTimeStep <Value> | <Value> is entered in Connect time units, and should be between 1.0e-5 to 315576000.0 seconds |
| TimeConvergence <Value> | This option sets the time tolerance that is used by the access algorithms to determine the start times and stop times of access intervals. <Value> is entered in Connect time units, and should be between 1.0e-9 to 315576000.0 seconds |
| RelValueConvergence <Value> | <Value> should be between 0.0 to 1.0 |
| AbsValueConvergence <Value> | <Value> should be between 1.0e-30 to 1.0e30 |
| EventsBasedOnSamples {On | Off} | Set EventsBasedOnSamples On to determine access intervals based on the samples without doing any extra sub-sampling. |
| FixedSampleStep {Off | (<FixedStep> <TimeBound>)} | Enter values to control the step size used in Access sampling. Enter either Off or both <FixedStep> and <TimeBound>.
<FixedStep> is entered in Connect time units, and should be between 1.0e-5 to 315576000.0 seconds. <TimeBound> is entered in Connect time units, and should be between 0.0 to 86400.0 seconds. |
| TimeSense {Receive | Transmit} | Allows you to set the direction of the signal. |
The following table describes {SlewOption} for setting Attitude Targeting Slew. Targeted Attitude must be turned On and at least one Target specified before setting the Slew options.
| {SlewOption} | Description |
|---|---|
| Mode {FixedTime | FixedRate | Constrained} | Set the value for slew mode. The default value is FixedTime.
If Constrained is entered the SlewType will be set to 2ndOrderSpline. |
| {SlewTime | MaxSlewTime} <Time> | Specify the time span in which you wish the vehicle to change from its original attitude to a target-pointing attitude and the amount of time required to change its pointing to another target. SlewTime and MaxSlewTime keywords are interchangeable, but for consistancy SlewTime is generally used when Mode is FixedTime and MaxSlewTime when Mode is FixedRate or Constrained. The <Time> is entered in Connect time units and must be greater or equal to 0 seconds. |
| MatchAngVel {On | Off} | Specify whether to take account of the angular velocity (slope) at the beginning and end of the slew.
This option is used if Mode is FixedTime. |
| SlewTimingBetweenTgts {TimingOption} | Specify when to execute the slew within the window of opportunity. Valid values for {TimingOption} are:
This option is used if Mode is FixedRate or Constrained. |
| 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.
This option is used when slew Mode is FixedRate or Constrained. |
| 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. These constraints are used when slew Mode is FixedRate or Constrained. |
| 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.
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. These constraints are used when slew Mode is Constrained. |
| AccelAxisY {On | Off | <Value>} | |
| AccelAxisZ {On | Off | <Value>} |
Examples
To turn the attitude pointing target option On and slew the ERS1 satellite so that its Z axis points in the direction of the Wallops facility when it is within view:
To replace a point in the targeting schedule for the basicLEO1 satellite using the Wallops facility as a target:
To change default selection of body vectors used in targeted attitude definitions:
Examples
Use the following commands to add two Lat, Lon, Alt targets to SatAtt, and set the time intervals for the targets:
Set access compute options for Satellite1:
Load target time intervals from a file:
Import the intervals from the FixedList17 time component:
Examples
Turn the attitude pointing target option On and set the target:
Set options for Fixed Rate slew mode:
Set options for Constrained slew mode:
Return message
Group membership
This command belongs to the following group(s):
Version
11.5