SetState GPS
Set the orbit state of a satellite from a GPS file.
Syntax
SetState <SatObjectPath> GPS <PRN> [{SetStateOption} <Value> ...]
Related Commands
Description
The SetState GPS command sets the orbit state of the satellite using information from an Almanac file, either yuma or sem, or from a GPS file (sp3) and the satellite ID specified.
Valid {SetStateOption} and associated <Value> are:
| {SetStateOption} | <Value> | Description |
|---|---|---|
| UpdateMode | {None | Online | FromFiles} | Specify whether the GPS satellite will be updated automatically. The default value is None.
If UpdateMode is omitted or set to None then the Catalog option is required. If UpdateMode is FromFiles then the SourceFile option is required. |
| NoProp | n/a | If included on the command line the satellite's state will be set but it will not be propagated. |
| TimePeriod | {TimeInterval} | Define the beginning and end of the satellite's time period.
For valid {TimeInterval} values see Time Options. The default value is the scenario analysis time period. |
| StepSize | <StepSize> | Enter a value representing the interval between calculated ephemeris output points in seconds. The default value is 60 seconds. |
| WeekRefEpoch | {06Jan1980 | 22Aug1999} | Enter the week reference epoch for the almanac file. The default value for WeekRefEpoch is 22Aug1999.
This option only applies when UpdateMode is None. |
| RetrieveMethod | {All | First} | Set the method for retrieving TLEs. The default value for RetrieveMethod is All. This option only applies when UpdateMode is Online. |
| SwitchMethod | {Epoch | MidPoint | TCA} | Set the method for switching between TLEs. This option is valid only if RetrieveMethod is All.
The default value for SwitchMethod is Epoch. This option only applies when UpdateMode is Online. |
| Catalog | "<Filename>" | If UpdateMode is None (the default) then this option is required. |
| SourceFile | "<Filename>" | If UpdateMode is FromFiles then this option is required. |
Example
Set the state for gpsSat1 using PRN 23 from the specified catalog file:
SetState */Satellite/gpsSat1 GPS 23 Catalog "C:\GPSData\almanac.sem.week0385.061440.txt"
Set the state for gpsSat2 using PRN 7 from the specified file, propagate it over the specified time period:
SetState */Satellite/gpsSat2 GPS 7 UpdateMode FromFiles SourceFile "C:\STKUser\Databases\GPSAlmanacs\GPSAlmanac.al3" TimePeriod "1 Jul 2006 12:00:00.00" "1 Jul 2006 16:00:00.00" StepSize 30.0
Set the state for gpsSat1, specifying Retrieve and Switch methods:
SetState */Satellite/gpsSat1 GPS 14 UpdateMode Online RetrieveMethod All SwitchMethod TCA
Set the state for gpsSat2 using PRN 12 from the specified file, propagate it over the Scenario time period:
SetState */Satellite/gpsSat2 GPS 7 UpdateMode FromFiles SourceFile "C:\STKUser\Databases\GPSAlmanacs\GPSAlmanac.al3" TimePeriod UseScenarioInterval StepSize 30.0
ReturnMessage
Group Membership
This command belongs to the following group(s):
Version
10.1
Visit AGI.com