Add or remove terrain data to be used in STK calculations
Terrain <ScenarioPath> {Action} <Parameters>
The Terrain command allows you to set the options for terrain imagery and data.
{Action} can be Add, Modify, Remove, TerrainServer, AddPreload, RemovePreload, ClearCache, TotalCacheSize.
This command allows you to specify terrain sources to add to a scenario, or modify terrain sources. The format for this command is:
Terrain <ScenarioPath> {Add | Modify} {Options} <Parameters>
The following table describes the {Options} <Parameters> available for the Terrain Add and Modify commands.
| {Options} <Parameters> | Description |
|---|---|
| Type {TerrainType} | Specify the terrain type. See table
below for valid {TerrainType} values.
Note: This option is required for the Terrain Add command. |
| File "<TerrainFile>" | Specify the terrain file.
Note: This option is required for the Terrain Add or Modify commands. |
| CentralBody <CBName> | Specify the Central Body of the terrain. If this option is not entered then the Scenario's central body will be used. |
| UseTerrain {On | Off} | Specify whether the terrain should be used in STK calculations. The default value is On. |
| MaxCacheSize <Size> | <Size> is entered in bytes, the default is 128 megabytes. Specify the amount of memory the cache for this terrain source can use. It must be between one megabyte (1,048,576 bytes) and two gigabytes (2,147,483,648 bytes). The MaxCacheSize should not be greater than the TotalCacheSize (see Terrain TotalCacheSize command below). |
| MaxCacheRegionSize <Size> | <Size> is entered in bytes, the default is 1 megabyte. Specify the amount of memory each region in the cache can use. It must be between 512 bytes and two gigabytes (2,147,483,648 bytes). |
The following table describes terrain types.
| {TerrainType} | Description |
|---|---|
| MRAS | MUSE Raster File (DTE). NGA (formerly known as NIMA) elevation data that has been converted using the MUSE software raster importer. MUSE terrain files contain position information. |
| DEM | Digital Elevation Model (DEM). U.S. Geological Survey data. Moderate resolution. |
| DMED | NIMA/NGA Terrain Directory (DMED). NGA (formerly known as NIMA) Digital Terrain Elevation Data (DTED). |
| HDR | STK World Terrain (HDR). DEM-derived data for the entire Earth. |
| GRD98 | GEODAS Grid Data (G98). GEODAS (GEOphysical DAta System) is an interactive database management system developed by the National Geophysical Data Center (NGDC) for use in the assimilation, storage and retrieval of geophysical data. |
| MOLA | Mars Orbiter Laser Altimeter terrain data |
| GTOPO30 | Global digital elevation model with horizontal grid spacing of 30 arc seconds. |
| ARCINFOBIN | ArcInfo Binary Grid format, using WGS84 as a vertical datum. |
| ARCINFOBINMSL | ArcInfo Binary Grid format, using MSL as a vertical datum. This is appropriate for NED terrain data. |
| ARCINFOGRIDDEPTHMSL | ArcInfo Grid format, using depths relative to MSL. |
| NIMAFile | NIMA/NGA Terrain Cell. The National Geospatial-Intelligence Agency (NGA) Terrain Cell files are the individual cells available on DTED CDROMs. |
| PDTT | PDTT Version 1 AGI Terrain file |
| TIFF | Tagged image format file |
| TIFFmsl | Tagged image format file, mean sea level |
This command allows you to remove a specified terrain file. If the CentralBody option is not entered then the command will remove the specified terrain from the Scenario's central body.
Terrain <ScenarioPath> Remove File "<TerrainFile>" [CentralBody <CBName>]
This command allows you specify how terrain is to be used.
Terrain <ScenarioPath> TerrainServer {Option} <Parameters>
The following table describes the {Option} <Parameters> available for the Terrain TerrainServer commands.
| {Option} <Parameters> | Description |
|---|---|
| UseTerrainForAnalysis {Yes | No} | Specify whether terrain elevation data is to be used in computations. |
| CoverageEnabled {Yes | No} | Specify whether to use terrain for Coverage analysis. |
| AzElMaskEnabled {Yes | No} | Specify whether to use terrain for an azimuth-elevation mask. |
| LineOfSightOnTerrainEnabled {Yes | No} | Specify whether terrain is to be used when determining line of sight. |
This command allows you to load a region of terrain into the cache. The RemovePreload option removes the region from the preloaded list.
Terrain <ScenarioPath> {AddPreload | RemovePreload} File "<TerrainFile>" South <Degrees> West <Degrees> North <Degrees> East <Degrees>
Valid values for South and North are -90 to 90 degrees. Valid values for East and West are -360 to 360 degrees.
This command allows you to clear the terrain cache and any lower level caches associated with the terrain source (i.e. file).
Terrain <ScenarioPath> ClearCache File "<TerrainFile>"
This command allows you to set the total cache size (i.e. not individual terrain sources) for the analytical terrain in a scenario. The default is 384 megabytes. <CacheSize> is entered in bytes and must be greater or equal to 1,048,576 bytes (1 megabyte).
Terrain <ScenarioPath> TotalCacheSize <CacheSize>
To add the w001001.adf file to the current scenario:
Terrain * Add Type ARCINFOBINMSL File "NED_05793792\ned_05793792\w001001.adf"
To add the testterrain.dte DEM file to the current scenario:
Terrain * Add Type DEM File "C:\My Documents\Terrain\testterrain.dte"
To add the world30 terrain, specifying cache size:
Terrain * Add Type HDR File "D:\Terrain\world30.hdr" MaxCacheSize 67108864 MaxCacheRegionSize 32768
To remove the world30 terrain:
Terrain * Remove File "D:\Terrain\world30.hdr"
To add the test2.dte terrain to the Moon:
Terrain * Add File "D:\Terrain\test2.dte" Type MRAS CentralBody Moon
To turn off the use of the test2.dte terrain on the Moon:
Terrain * Modify File "D:\Terrain\test2.dte" Type MRAS CentralBody Moon UseTerrain Off
To remove the test2.dte terrain from the Moon:
Terrain * Remove File "D:\Terrain\test2.dte" Type MRAS CentralBody Moon
To set the total cache size for the scenario:
Terrain * TotalCacheSize 1073741824
To use terrain elevation data for azimuth elevation masks:
Terrain * TerrainServer AzElMaskEnabled Yes
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
11
STK Programming Interface 11.0.1