Define and modify Spatial Calculation components and templates.
SpatialTool <ScenarioPath> <ParentObject> {Action} {Spatial Calculation | Spatial CalculationTemplate} <Spatial CalculationName> [{Spatial CalculationType} <Spatial CalculationTypeParams>]
The SpatialTool Spatial Calculation command is used to add, modify and delete Spatial Calculation components and templates.
For a component object the <ParentObject> is a truncated object path or a Central Body path.
For a template the <ParentObject> is an STK class name, and the Spatial CalculationTemplate keyword must be entered.
The following table provides a description of {Action} values and the applicable parameters:
| {Action} | Parameters | Description |
|---|---|---|
| Create | {Spatial CalculationType} [<Spatial CalculationTypeParams>] | <Spatial CalculationTypeParams> are optional, except where noted below. If no <Spatial CalculationTypeParams> are specified, default values are used. |
| Modify | {Spatial CalculationType} <Spatial CalculationTypeParams> | The values <Spatial CalculationName> {Spatial CalculationType} must define an existing Spatial Calculation component or template. The {Spatial CalculationType} can not be modified. <Spatial CalculationTypeParams> are required. |
| Delete | N/A | Delete the component or template identified by <Spatial CalculationName> |
The following table describes each Spatial Calculation type and it's parameters.
| {Spatial CalculationType} | <Spatial CalculationTypeParams> |
|---|---|
| "Altitude At Location" |
Any or all of the following keyword-value pairs can be specified:
Note: Only Earth can have ShapeModel set to MSL. |
| "Angle To Location" |
Any or all of the following keyword-value pairs can be specified:
The following list indicates which parameters are valid for the Angle types:
|
| "Atmospheric Density At Location" |
Valid "<Model>" values include the Atmospheric Density models in your installation of STK, this may include: "1976 Standard", "Jacchia 1970", "CIRA 1972", and others. Valid value for <DailyF10.7> is an integer between 65 and 275 Valid values for <AverageF10.7> is an integer between 65 and 275 Valid values for <Kp> is a real number between 0 and 10 Note: The Atmospheric Density Spatial Calculation is valid only for Central Bodies. |
| "Distance To Location" |
Any or all of the following keyword-value pairs can be specified:
The following list indicates which parameters are valid for the Distance types:
|
| "Propagation Delay To Location" |
Any or all of the following keyword-value pairs can be specified:
The following list indicates which parameters are valid for the Range types:
|
| "Scalar At Location" |
Note: The Scalar at Location Spatial Calculation is not valid for Central Bodies. Note: The Scalar parameter is required when Creating the "Scalar At Location" Spatial Calculation. |
| "Spatial Condition Satisfaction Metrics" |
Any or all of the following keyword-value pairs can be specified:
The DurationType option is not valid if Metric is NumberOfGaps or NumberOfIntervals. The MaxNumIntervals option is valid only if Filter is FirstIntervals or LastIntervals. The UseMinimum and UseMaximum options are valid only if Filter is GapDuration or IntervalDuration. The MaxNumIntervals <Value> is an integer between 1 and 575. The <MinValue> and <MaxValue> are entered in Connect time units and are greater or equal to 0 seconds. |
For details on the format of a reference component (e.g. "<SpatialCondition>", "<Vector>", etc.) see Component Specification.
The following table describes Spatial Calculation types that are valid for Satellite, Missile & Launch Vehicle.
| {Spatial CalculationType} | <Spatial CalculationTypeParams> |
|---|---|
| "SEET Electron/Proton Radiation At Location" |
The ParticleEnergy <Value> is entered in MeV. |
| "SEET Impact Flux At Location" |
|
| "SEET Magnetic Field At Location" |
Valid values for "<Name>" are:
|
| "SEET SAA Flux At Location" |
|
To create and modify a new Altitude At Location type Spatial Calculation:
SpatialTool * Satellite/ScenTestSat Create "Spatial Calculation" SatSCalc6 "Altitude At Location"
SpatialTool * Satellite/ScenTestSat Modify "Spatial Calculation" SatSCalc6 "Altitude At Location" CentralBody Earth ShapeModel Terrain UseCustomReference Yes ReferencePoint "Satellite/ScenTestSat2 Center Point"
To create and modify a Spatial Condition Satisfaction Metrics Spatial Calculation:
SpatialTool * Satellite/ScenTestSat Create "Spatial Calculation" SatSCalc7 "Spatial Condition Satisfaction Metrics"
SpatialTool * Satellite/ScenTestSat Modify "Spatial Calculation" SatSCalc7 "Spatial Condition Satisfaction Metrics" Filter IntervalDuration AccumulationType FromCurrent
To create, modify and then delete a Distance To Location Spatial Calculation Template:
SpatialTool * Facility Create "Spatial CalculationTemplate" FacSCalc4 "Distance To Location"
SpatialTool * Facility Modify "Spatial CalculationTemplate" FacSCalc4 "Distance To Location" Distance AlongVectorSigned AlongVector "Facility Moon Vector"
SpatialTool * Facility Delete "Spatial CalculationTemplate" FacSCalc4 "Distance To Location"
To create and modify a new SEET SAA Flux At Location type Spatial Calculation:
SpatialTool * Missile/agrad Create "Spatial Calculation" MslFlux "SEET SAA Flux At Location" ProtonChannel 94
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
11
STK Programming Interface 11.0.1