ImportFromDB

Import Cities, Facilities and Satellites from the database or Stars from a collection.

Syntax

ImportFromDB <ScenarioPath> {Type} {Source} [{Options}] {SearchParameters}

Related Commands

• CreateTLEFile
• ImportTLEFile (Satellites)
• ImportAlmanacFile

Description

The ImportFromDB allows the user to import Cities, Facilities and Satellites from the STK database and Stars from a Star catalog or collection. Valid values for {Type} are City, Facility, Satellite, Star. The tables below show the details and options available for each type.

Warning: Please use caution with this command. Use the search parameters to limit the number of imported objects. If you enter a command that results in hundreds or thousands of objects being loaded, be prepared to wait until the loading is completed.

This command will Nack if no matches are found using the search criteria.

City Database

The {Source} is a "<FilePath>" for the city database and should have the extension ".cd".

The first table lists the Create {Options} for the City database. None of these options is required.

The following table describes the {SearchParameters} for the City database. At least one {SearchParameters} must be entered with the command. Values specified as <Name> are character values and can include a wildcard, e.g. CityName Lon*. If the desired value contains a space then the <Name> must be enclosed in double quotes, e.g. Country "Burkina Faso"

Facility Database

The {Source} is a "<FilePath>" for the facility database and should have the extension ".fd".

The first table lists the Create {Options} for the Facility database. None of these options is required.

The following table describes the {SearchParameters} for the Facility database. At least one {SearchParameters} must be entered with the command. Values specified as <Name> are character values and can include a wildcard, e.g. Network NASA*. If the desired value contains a space then the <Name> must be enclosed in double quotes, e.g. Network "NASA GNR"

Satellite Database

The {Source} can be any of the following or can be omitted:

For information on setting SGP4 Propagator default values refer to the SetPropagatorDefaults command or Edit - Preferences - Propagator Defaults.

The next table lists the Source {Options} for the Satellite database. None of these options is required.

The next table lists the Create {Options} for the Satellite database. None of these options is required.

The following table describes the {SearchParameters} for the Satellite database. At least one {SearchParameters} must be entered with the command. Values specified as <Name> are character values and can include a wildcard, e.g. InternationalNumber 2003*. If the desired value contains a space then the <Name> must be enclosed in double quotes, e.g. Owner "Burkina Faso"

Star Collection or Catalog

The {Source} is a "<StarCatalog>", "<StarCollection>" or ScenarioCollection. Enter the name of a Star catalog or collection; or enter the keyword ScenarioCollection to use the current default Star collection.

The first table lists the Create {Options} for the Star collection or catalog. None of these options is required.

The following table describes the {SearchParameters} for the Star database. At least one {SearchParameters} must be entered with the command.

Example

The following command will import Accra and London from the City database:

ImportFromDB * City "C:\ProgramData\AGI\STK 11\Databases\City\stkCityDb.cd" Type "National Capital" Province Gr*

Import the four facilities that have an altitude of 0.0 and lie between 10.0 and 20.0 degrees latitude, create the facilities as Target objects, and place them in a constellation named Test4:

ImportFromDB * Facility "C:\ProgramData\AGI\STK 11\Databases\Facility\stkFacility.fd" Class Target Constellation Test4 Altitude 0.0 0.0 Latitude 10.0 20.0

Import the facilities that have an altitude of 0.0 and lie between 10.0 and 20.0 degrees latitude, create the facilities as Target objects, and name them FacMan, FacMan1, etc:

ImportFromDB * Facility "C:\ProgramData\AGI\STK 11\Databases\Facility\stkFacility.fd" Class Target Rename FacMan Altitude 0.0 0.0 Latitude 10.0 20.0

The following command will import the satellite with the SSC Number 23027:

ImportFromDB * Satellite DefaultSatDB SSCNumber 23027

The following command will import and propagate the satellites matching the search criteria:

ImportFromDB * Satellite DefaultSatDB Propagate On TimePeriod "1 Jun 2004 12:00:00.000" "1 Jun 2004 14:00:00.000" CommonName iss* Mission MANNED InternationalNumber 2003*

Import the satellite data from the AGI Server and propagate over the Scenario interval:

ImportFromDB * Satellite AGIServer Propagate On TimePeriod UseScenarioInterval SSCNumber 11417

The following command will import the two stars whose criteria fall within the magnitude and right ascension entered:

ImportFromDB * Star ScenarioCollection VisualMagnitude 0 1.0 RightAsc 200.0 230.0

The following command will import the stars in the constellation "Canis Major":

ImportFromDB * Star "Hipparcos 2 Mag 6" InConstellation "Canis Major"

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Scenarios

Version

10

STK Programming Interface 11.0.1