Description | Example | Return message | Group

SpatialTool

Define volumes and elements used in constructing them, including templates.

Syntax

SpatialTool <ScenarioPath> {Options}

Related commands

Description

The SpatialTool command enables you to define coordinate systems and elements used in constructing them, i.e. vectors, axes and points, as well as angles between vectors. These user-created structures and elements can then be added to those available for 3D display in the VO and/or Attitude View windows.

The SpatialTool command is not valid for Chain, CommSystem, Constellation, CoverageDefinition, Star, or Scenario objects.

Valid {Options} are described here.

{Options}Description
Compute "<ComponentSpec>"Compute the Spatial component. This command will Nack if the component is already computed or cannot be computed.

To get the Compute/Clear status of a Spatial component use the SpatialTool_R command with the Status option.

The Compute option is not valid for a template.

Clear "<ComponentSpec>"Clear the Spatial component.This command will Nack if the component is already cleared or cannot be cleared.

To get the Compute/Clear status of a Spatial component use the SpatialTool_R command with the Status option.

The Clear option is not valid for a template.

Export "<Filename>" "<ComponentSpec>"... Export the specified components to a file.

"<Filename>" is the file that will be written, it should have the extension .awb. If the file already exists it will be overwritten.

"<FilePath>" 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.

"<ComponentSpec>" is the name of a component to be exported. This parameter can be entered multiple times on the command line.

All components exported to one file must have the same parent.

Import <TruncObjectPath> "<Filename>"Import the components from the specified "<Filename>".

<TruncObjectPath> specifies the parent of the imported components.

"<Filename>" 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.

Rename "<ComponentSpec>" <NewName>Rename the specified Spatial component to the new name.
RenameTemplate "<TemplateSpec>" <NewName>Rename the specified Spatial template to the new name.
Duplicate "<ComponentSpec>" [<NewName>]Duplicate the specified Spatial component using the <NewName>, if entered. If <NewName> is not entered then STK will create a unique name for the duplicate component.
DuplicateTemplate "<TemplateSpec>" [<NewName>]Duplicate the specified Spatial template using the <NewName>, if entered. If <NewName> is not entered then STK will create a unique name for the duplicate template.
UserDescription "<ComponentSpec>" "<Description>"Add a user description to the specified Spatial component or template.

If "<Description>" is more than 300 characters it will be truncated to 300.

The user description cannot be changed on the following read-only items: component from template, installed components and templates, and embedded components.

{Create | Modify | Delete}

Follow these links for details to using the SpatialTool command to Create, Modify and Delete Spatial components and templates.

SpatialTool Spatial CalculationSpatialTool Spatial ConditionSpatialTool Volume Grid

For details on the format of "<ComponentSpec>" see Component Specification.

Examples

To compute a Volume Grid:

SpatialTool * Compute "Satellite/ScenTestSat SatGrid4 Volume Grid"

Examples

To create an Angle Off Reference Spatial Calculation and then modify it:

SpatialTool * Satellite/ScenTestSat Create "Spatial Calculation" SatSCalc1 "Angle Off Reference"
SpatialTool * Satellite/ScenTestSat Modify "Spatial Calculation" SatSCalc1 "Angle Off Reference" Angle AboutVectorSigned AboutVector "Satellite/ScenTestSat Moon Vector"

Examples

To create an Spatial Calculation Bounds component and then delete it:

SpatialTool * Satellite/ScenTestSat Create "Spatial Condition" SatCond6 "Spatial Calculation Bounds"
SpatialTool * Satellite/ScenTestSat Delete "Spatial Condition" SatCond6

Examples

Rename the specified Spatial Calculation component to SatCalc2 and then duplicate it, allowing STK to name the duplicated component:

SpatialTool * Rename "Satellite/Satellite2 TempName Spatial Calculation" SatCalc2
SpatialTool * Duplicate "Satellite/Satellite2 SatCalc2 Spatial Calculation"

Rename the specified Spatial Condition template:

SpatialTool * RenameTemplate "Satellite dirCond Spatial Condition" satCondition

Examples

Add a user description to a Spatial Condition template:

SpatialTool * UserDescription "Satellite satCondition Spatial Condition" "The satellite condition template."

Add a user description to a Spatial Calculation component:

SpatialTool * UserDescription "Satellite/Satellite2 SatSCalc1 Spatial Calculation" "My very special Spatial Calculation."

Return message

Group membership

This command belongs to the following group(s):

Area Targets

Comm

Facilities, Places & Targets

Line Targets

Radar

Sensors

Object Tools

Vehicles

Volumetric

VO

VO Objects

Version

11.5