Description | Example | Return message | Group

SpatialTool Spatial Calculation

Define and modify Spatial Calculation components and templates.

Syntax

SpatialTool <ScenarioPath> <ParentObject> {Action} {Spatial Calculation | Spatial CalculationTemplate} <Spatial CalculationName> [{Spatial CalculationType} <Spatial CalculationTypeParams>]

Related commands

Description

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}ParametersDescription
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.
DeleteN/ADelete the component or template identified by <Spatial CalculationName>

The following table describes each Spatial Calculation type and its parameters.

{Spatial CalculationType}<Spatial CalculationTypeParams>
"Altitude At Location"

Any or all of the following keyword-value pairs can be specified:

  • CentralBody <CBName>
  • ShapeModel {Ellipsoid | Terrain | MSL}
  • UseCustomReference {Yes | No}
  • ReferencePoint "<Point>"

Only Earth can have ShapeModel set to MSL.

"Angle To Location"

Any or all of the following keyword-value pairs can be specified:

  • Angle {AboutVectorSigned | AboutVectorUnsigned | OffVector | OffPlaneSigned | OffPlaneUnsigned}
  • ReferencePoint "<Point>"
  • ReferenceVector "<Vector>"
  • ReferencePlane "<Plane>"
  • AboutVector "<Vector>"

The following list indicates which parameters are valid for the Angle types:

  • AboutVectorSigned : ReferencePoint, ReferenceVector, AboutVector
  • AboutVectorUnsigned : ReferencePoint, ReferenceVector, AboutVector
  • OffVector : ReferencePoint, ReferenceVector
  • OffPlaneSigned : ReferencePlane
  • OffPlaneUnsigned : ReferencePlane
"Atmospheric Density At Location"
  • "<Model>" {Manual <DailyF10.7> <AverageF10.7> <Kp> | File "<File>"}

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 40 and 10000

Valid values for <AverageF10.7> is an integer between 40 and 10000

Valid values for <Kp> is a real number between 0 and 10

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:

  • Distance {AlongVectorSigned | AlongVectorUnsigned | FromPoint | FromPlaneSigned | FromPlaneUnsigned}
  • ReferencePoint "<Point>"
  • ReferencePlane "<Plane>"
  • AlongVector "<Vector>"

The following list indicates which parameters are valid for the Distance types:

  • AlongVectorSigned : ReferencePoint, AboutVector
  • AlongVectorUnsigned : ReferencePoint, AboutVector
  • FromPoint : ReferencePoint
  • FromPlaneSigned : ReferencePlane
  • FromPlaneUnsigned : ReferencePlane
"File"
  • Filename "<Filepath>"
  • Reload

"<Filepath>" is a file in HDF5 format (*.h5).

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

The Filename "<Filepath>" parameter is required when Creating the "File" Spatial Calculation

The Reload parameter is valid for a Modify command only, and should be the only parameter on the command.

"Propagation Delay To Location"

Any or all of the following keyword-value pairs can be specified:

  • Range {AlongVectorSigned | AlongVectorUnsigned | FromPoint | FromPlaneSigned | FromPlaneUnsigned}
  • ReferencePoint "<Point>"
  • ReferencePlane "<Plane>"
  • AlongVector "<Vector>"
  • SpeedType {Light | Custom}
  • Speed <Value>

The following list indicates which parameters are valid for the Range types:

  • AlongVectorSigned : ReferencePoint, AboutVector
  • AlongVectorUnsigned : ReferencePoint, AboutVector
  • FromPoint : ReferencePoint
  • FromPlaneSigned : ReferencePlane
  • FromPlaneUnsigned : ReferencePlane
"Scalar At Location"
  • Scalar "<CalcScalar>"

The Scalar at Location Spatial Calculation is not valid for Central Bodies.

The Scalar parameter is required when Creating the "Scalar At Location" Spatial Calculation.

"Solar Intensity"
  • UseParentBodies {Yes | No}
  • EclipsingBody {CentralBodyName}

The EclipsingBody {CentralBodyName} parameter should be included when UseParentBodies is No. This parameter can be entered multiple times on the command, and the CentralBodies named will replace the current Eclipsing Body list.

"Spatial Condition Satisfaction Metrics"

Any or all of the following keyword-value pairs can be specified:

  • SpatialCondition "<SpatialCondition>"
  • Metric {NumberOfGaps | NumberOfIntervals | IntervalDuration | GapDuration | SinceLastSatisfaction | UntilNextSatisfaction}
  • DurationType {Minimum | Maximum | Sum}
  • AccumulationType {CurrentTime | UpToCurrent | FromCurrent | Total}
  • Filter {None | FirstIntervals | LastIntervals | GapDuration | IntervalDuration}
  • MaxNumIntervals <Value>
  • UseMinimum {No | <MinValue>}
  • UseMaximum {No | <MinValue>}

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"
  • FluxType {Electron | Proton}
  • ParticleEnergy <Value>

The ParticleEnergy <Value> is entered in MeV.

"SEET Impact Flux At Location"
  • FluxType {ImpactFlux | MassFlux | ImpactRate | MassRate}
  • FluxMode {Impacts | DamagingImpacts}
"SEET Magnetic Field At Location"

Parameter "<Name>"

Valid values for "<Name>" are:

  • "Total Intensity"
  • "North Intensity"
  • "East Intensity"
  • "Down Intensity"
  • "Horizontal Intensity"
  • "Magnetic Declination"
  • "Magnetic Inclination"
  • "Dipole L-shell"
  • "McIlwain L-shell"
  • "Absolute value of McIlwain L-shell"
  • "B/Beq relative intensity"
  • "Beq relative intensity at equator"
  • "Field line separation angle"
  • "Field line longitude separation angle"
"SEET SAA Flux At Location"

ProtonChannel {23 | 38 | 66 | 94}

Examples

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"

Examples

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

Examples

To create a new Solar Intensity Spatial Calculation witht he specified eclipsing bodies:

SpatialTool * Satellite/ScenTestSat Create "Spatial Calculation" SolarCalc "Solar Intensity" UseParentBodies No EclipsingBody Mercury EclipsingBody Venus EclipsingBody Mars

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