Description | Example | Return message | Group

Spice

Loads, removes, or reorders Spice ephemeris files.

Syntax

Spice <ScenarioPath> {Action} [<Parameters>]

Description

The Spice Connect command enables you to load, remove, or reorder Spice ephemeris files. If you want to get information about Spice files, you can use the Spice_RM command.

ActionDescription
Load <FullFilepath>Loads a spice ephemeris file if it is not already loaded. If already loaded, it does nothing.
Remove <Filepath>Unloads a spice ephemeris file. If the filename is unique, then the filename may be used instead of the full filepath that includes the directory.

This may remove the ability of a central body to compute ephemeris, if the central body uses spice and the file being removed contributes to that central body's spice ephemeris.

If a vehicle is set to use this Spice file as part of the Spice propagator setings, then the vehicle no longer is able to compute its ephemeris. Re-applying the Spice propagator settings then loads the file.

The removal of a file from the Install, AllUsers, or user Config Spice folders is not preserved as part of the scenario saved data. This file is reloaded on Scenario load.

Move <FullFilepath> {Ahead | Behind} <Steps>Moves the location of the currently loaded ephemeris file by the number of <Steps> from its current location, either earlier or later in the file ordering. If the filename is unique, then the filename may be used instead of the full filepath that includes the directory. This can be useful when a Spice file contains ephemeris for a bodyId that overlaps ephemeris provided by a different file. Spice's precendence scheme uses the later file when such a conflict exists (i.e. when more than one file can supply ephemeris at a requested time, the higher priority is used (i.e. the file loaded latest).
OutputErrorMsgsOnLoad {Yes, True, 1, No, False, 0}Sets a flag used during scenario load that indicates that an error message should be written to the message viewer if a Spice ephemeris file is missing. This is defaulted as False to avoid messages being written for missing files that were loaded but were not actually in use by the scenario.

Examples

To load the Spice file:

Spice * Load "C:\Program Files\AGI\STK 12\STKData\Spice\neptune.bsp"

To remove the Spice file:

Spice * Remove "C:\Program Files\AGI\STK 12\STKData\Spice\neptune.bsp"

Move the Spice file:

Spice * Move "neptune.bsp" Ahead 6

OutputErrorMsgsOnLoad:

Spice * OutputErrorMsgsOnLoad True

Return message

Group membership

This command belongs to the following group(s):

Application Options

CAT

Scenarios

Stars & Planets

Vehicles

Version

12.4