Description | Example | Return Message | Group

SetState File

Set the path of a vehicle from an external ephemeris file (Deprecated Command)

Syntax

SetState <VehObjectPath> File "<FilePath>" [{Options}]

ATTENTION: THIS COMMAND IS DEPRECATED and has been replaced by:

SetState FromFile

Description

Note: This command was deprecated in STK 10.1, it should no longer be used. This command has been replaced by the SetState FromFile command.

The SetState File command with the File {PropagatorType} option loads the path of a vehicle from a specified ephemeris file.

The "<FilePath>" is the path and filename of an ephemeris file that you wish to load. See the {Format} parameter below for valid ephemeris file formats.

Any or all of the following options can be entered, but if more than one option is entered they must be entered in the order given in the table below.

{Options} Description
{EphemStartTime} Use this option if the first ephemeris point in the ephemeris file being loaded is to be at a time different than the one specified in the file.

For valid {EphemStartTime} values see Time Options.

{Format} Valid values for {Format} include STK Ephemeris (*.e), STK Binary ephemeris (*.be), Code500Ephem (*.EPH), CCSDS_OEM (.oem), and other valid ephemeris formats that STK recognizes. These values are case-sensitive.

If no {Format} is entered then the ephemeris type is determined by the file extension. If the file has no extension or the ephemeris format can not be determined from the extension then STK Ephemeris will be used.

{SaveFile | SaveLocally} Enter SaveFile to have the Save command write the entire ephemeris to the file specified by the "<FilePath>".

Warning: Using the SaveFile option will overwrite the original ephemeris file unless the original file is renamed.

Enter SaveLocally to have the Save command write the ephemeris file to the user's current Scenario directory. When the vehicle is reloaded into STK, the local version of the ephemeris file will be used.

Use the SaveLocally option when you want a vehicle's external ephemeris file to be saved in the same directory as the vehicle with which it is associated regardless of where on your computer system the external ephemeris file originally resided. This makes it much easier to locate the ephemeris files that you have associated with a specific vehicle.

Note: This option applies only to STK Ephemeris and STK Binary ephemeris files.

Example

To use the data from STK Ephemeris file EphemFile.e when propagating ephemeris for the Shuttle satellite:

SetState */Satellite/Shuttle File "C:\stk\User\Data\EphemFile.e"

Save the file from which you loaded the ratpack1 missile's ephemeris back to its original location and overwrite the original ephemeris file:

SetState */Missile/ratpack1 File "c:\FtpDir\missilex.e" SaveFile

Save the file from which you loaded the ratpack1 missile's ephemeris to the default stk user directory:

SetState */Missile/ratpack1 File "c:\FtpDir\missilex.e" SaveLocally

To change the start time of the first ephemeris point in ephemeris file Satellite1.e being used by Satellite3 in the active scenario:

SetState */Satellite/Satellite3 File "c:\stkDB\Satellite1.e" "1 Jun 2003 14:00:00.00"

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Vehicles

Deprecated Commands

Version

10.1

STK Programming Interface 11.0.1