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. You can also specify a target 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 you can only create it or modify it via Connect.
{TargetOption} can be:
| {TargetOption} | <Value> | Description |
|---|---|---|
| {On | Off} | N/A | If On, STK will use the targeted attitude. |
| Add | {TargetSpec} | Specify the path of the target object. |
| Remove | ||
| Clear | N/A | Remove all targets. |
| Slew | {SlewOptions} | Set options for targeting slew. See the table below for a 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.
You can also set the reference constraint vector 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, and 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 with creating the STK interval file, see Using STK > Data Management > Create & Import External Files > Interval List in STK Help.
"<IntervalFile>" is the path to a file on your local drive. |
| 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. Enter <Value> in Connect time units, between 1.0e-9 and 0.1 seconds. |
| AberrationType {Total | Annual | None} | Set the model of aberration to be used in access computations. |
| MinTimeStep <Value> | Enter <Value> in Connect time units, between 1.0e-5 and 315576000.0 seconds |
| MaxTimeStep <Value> | Enter <Value> Connect time units, between 1.0e-5 and 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. Enter <Value> in Connect time units, between 1.0e-9 and 315576000.0 seconds. |
| RelValueConvergence <Value> | <Value> should be 0.0 to 1.0. |
| AbsValueConvergence <Value> | <Value> should be 1.0e-30 to 1.0e30. |
| EventsBasedOnSamples {On | Off} | Set EventsBasedOnSamples On to determine access intervals based on the samples without doing any extra subsampling. |
| FixedSampleStep {Off | (<FixedStep> <TimeBound>)} | Enter values to control the step size used in Access sampling. Enter either Off or both <FixedStep> and <TimeBound>.
Enter <FixedStep> in Connect time units, between 1.0e-5 and 315576000.0 seconds. Enter <TimeBound> in Connect time units, between 0.0 and 86400.0 seconds. |
| TimeSense {Receive | Transmit} | Enables you to set the direction of the signal. |
The following table describes {SlewOption} for setting Attitude Targeting Slew. Targeted Attitude must be 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 you enter Constrained, the SlewType will be 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 consistency SlewTime is generally used when Mode is FixedTime and MaxSlewTime when Mode is FixedRate or Constrained. Enter <Time> in Connect time units, greater than or equal to 0 seconds. |
| MatchAngVel {On | Off} | Specify whether or not to take into account the angular velocity (slope) at the beginning and end of the slew.
This option is applicable 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 applicable 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 applicable when slew Mode is FixedRate or Constrained. |
| RateAxisX {On | Off | <Value>} | Set this to On or Off, or set values for the maximum slew rate axis constraints.
If you enter <Value>, the constraint will be also be turned On. Enter <Value> in degrees/second, 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 applicable when slew Mode is Constrained. |
| AccelAxisX {On | Off | <Value>} | You can enter On or Off or set values for the maximum slew acceleration axis constraints.
If you enter a <Value>, the constraint will be also be turned On. Enter the <Value> in degrees/second^2, 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
12.10