Description | Example | Return Message | Group

Atmosphere

Control the use of atmospheric models

Syntax

Atmosphere <ObjectPath> SetValue <AttributePath> <Value> [<Unit>]

Related Commands

Description

The Atmosphere Connect command allows you to apply atmospheric models to Comm and Radar analyses. It specifies the local surface atmospheric conditions used by the gaseous absorption and rain models. Use the Atmosphere command with the SetValue option to set the value of specific attributes.

Hint: Valid objects for <ObjectPath> are Facilities, Places, Targets, Ground Vehicles, Ships, Aircraft, LaunchVehicles and Missiles. Satellites are not valid objects for the Atmosphere command.

Parameter Description
<AttributePath> Specify the path the attribute being changed.
<Value> The specified attribute will be set to this value.
<Unit> When entering a numeric value include the <Unit> to specify the abbreviation of the unit that the numeric value is being entered in. If not included then the <Value> is assumed to be in the internal units.

Use this command in conjunction with the Atmosphere_RM GetValue command, which will return a list of attributes, or the properties and choices for a specific attribute.

Example

Use the Atmosphere_RM GetValue command to see the names and settings of the Facility's Atmosphere attributes, numeric values are shown in internal units:

Atmosphere_RM */Facility/Perth GetValue

UserComment = STK Atmosphere Extension
InheritAtmosAbsorptionModel = true
AtmosAbsorptionModel = Simple_Satcom (Read-only)
AtmosAbsorptionModel.UserComment = Simple Satcom gaseous absorption model (Read-only)
AtmosAbsorptionModel.SurfaceTemperature = 293.15000000 K (Read-only)
AtmosAbsorptionModel.WaterVaporConcentration = 7.50000000 g*m^-3 (Read-only)
EnableLocalRainData = false
LocalRainIsoHeight = 2000.00000000 m (Read-only)
LocalRainRate = 1.00000000 mm*hr^-1 (Read-only)
LocalSurfaceTemp = 293.15000000 K (Read-only)

Set the Facility to use local rain data, this will also remove the Read-only property from the local rain data attributes so that they can be modified:

Atmosphere */Facility/Perth SetValue EnableLocalRainData true

To set the local rain data height (entered in kilometers), rate and temperature (entered in Fahrenheit):

Atmosphere */Facility/Perth SetValue LocalRainIsoHeight 0.28 km
Atmosphere */Facility/Perth SetValue LocalRainRate 2.90
Atmosphere */Facility/Perth SetValue LocalSurfaceTemp 30 degF

Example

To use local values for gaseous absorption set the Inherit flag for Atmospheric Absorption Model to false:

Atmosphere */Facility/Perth SetValue InheritAtmosAbsorptionModel false

To see the available Atmospheric Absorption Model names use the Atmosphere_RM GetValue command with the Choices option on the AtmosAbsorptionModel attribute:

Atmosphere_RM */Facility/Perth GetValue AtmosAbsorptionModel:Choices

ITU-R_P676-5
Script_Plugin
Simple_Satcom
TIREM_3.31
ITU-R_P676-3
TIREM_3.20

To change the Atmospheric Absorption Model to ITU-R_P676-5:

Atmosphere */Facility/Perth SetValue AtmosAbsorptionModel ITU-R_P676-5

Now use the Atmosphere_RM GetValue command, specifying the AtmosAbsorptionModel attribute to get the current settings of the Facility's atmosphere attributes.

Atmosphere_RM */Facility/Perth GetValue AtmosAbsorptionModel

AtmosAbsorptionModel = ITU-R_P676-5
AtmosAbsorptionModel.UserComment = ITU-R P676-5 gaseous absorption model
AtmosAbsorptionModel.UseApproxMethod = true
AtmosAbsorptionModel.UseSeasonalRegional = true

To set the UseSeasonalRegional attribute:

Atmosphere */Facility/Perth SetValue AtmosAbsorptionModel.UseSeasonalRegional false

Group Membership

This command belongs to the following group(s):

Comm

Facilities, Places & Targets

Radar

Vehicles

Version

9.0

STK Programming Interface 11.0.1