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 | 07Apr2019} | Enter the week reference epoch for the almanac file. The default value for WeekRefEpoch is determined as the latest prior date relative to the scenario epoch.
This option only applies when UpdateMode is None or FromFiles. |
| 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. |
"<Filename>", for Catalog or SourceFile, 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.
Examples
Set the state for gpsSat1 using PRN 23 from the specified catalog file:
Set the state for gpsSat2 using PRN 7 from the specified file, propagate it over the specified time period:
Set the state for gpsSat1, specifying Retrieve and Switch methods:
Set the state for gpsSat2 using PRN 12 from the specified file, propagate it over the Scenario time period:
Return message
Group membership
This command belongs to the following group(s):
Version
11.5