Set the orbit state of a satellite from a GPS file.
SetState <SatObjectPath> GPS <PRN> [{SetStateOption} <Value> ...]
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.
Note: If UpdateMode is omitted or set to None then the Catalog option is required. Note: 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.
Note: This option only applies when UpdateMode is None. |
| RetrieveMethod | {All | First} | Set the method for retrieving TLEs. The
default value for RetrieveMethod is All.
Note: 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. Note: 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. |
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
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
10.1
STK Programming Interface 11.0.1