Description | Example | Return Message | Group

Environment (Comm & Radar)

Control the use of environmental models in a scenario (Deprecated Command)

Syntax

Environment <ScenarioPath> {EnvironmentOption}

ATTENTION: THIS COMMAND IS DEPRECATED and has been replaced by:

Environment

Description

Note: This command was deprecated in STK 9, it should no longer be used. This command has been replaced by the Environment command.

The Comm Connect commands were enhanced in STK 9 to make use of attributes and to simplify the format required to use these commands. For more information on using the new format with the Atmosphere command, see Transitioning to the New Environment Connect Format.

The Environment command allows you to apply environmental models to Comm and Radar analyses. The Comm and Radar Modules include models for rain fade and gaseous absorption.

{EnvironmentOption} Description
RainModel {On | Off} [{ModelType} {<Temperature> | "<Filename>"}] Valid values for {ModelType} are: Crane1982, Crane1985, CCIR1983, ITU_P618_5, ITU_P618_7, ITU_P618_8, and PluginRainModel.

If {ModelType} is PluginRainModel, you must specify a "<Filename>".

For all other {ModelTypes}, <Temperature> is the only valid option. <Temperature> is entered in degrees C, valid values are -100.0 to 100.0.

Absorption {On | Off} ["{ModelType}" {parameters}] Valid values for "{ModelType}" {parameters} are:
  • "Simple Satcom" <Vapor> <Temperature>
  • "ITU-R P.676-3" {UseFastOn | UseFastOff} {UseSeasonOn | UseSeasonOff} <Altitude>
  • "ITU-R P.676-5" {UseFastOn | UseFastOff} {UseSeasonOn | UseSeasonOff}
  • "Plugin Atmos Absorption Model" "<Filename>"
  • "Tirem 3.10" <Humidity> <Conductivity> <Refractivity> <Permittivity>
  • "Tirem 3.16" <Humidity> <Conductivity> <Refractivity> <Permittivity>

Note: Tirem 3.10 and Tirem 3.16 have been deprecated in STK 10.1.

<Vapor> is entered in g/m^3. Valid values are 0.0 to 100.0.

<Temperature> is entered in degrees C. Valid values are -100.0 to 100.0.

<Altitude> is entered in Connect distance units, valid values are 0.0 to 20.0 km.

<Humidity> is entered in g/m^3. Valid values are 0.0 to 110.0.

<Conductivity> is entered in Siemens per meter (S/m). Valid values are 0.00001 to 100.0.

<Refractivity> is unitless. Valid values are 200.0 to 450.0.

<Permittivity> is unitless. Valid values are 0.0 to 100.0.

Note: The {ModelType} "Tirem 3.10" and "Tirem 3.16" are only available if you have a TIREM license.

Note: Valid values for "{ModelType}" are case-sensitive and are obtained from registered RF absorption definitions.

CloudFog

[Compute {On | Off}]

[Ceiling <Value>]

[Thickness <Value>]

[Temperature <Value>]

[Density <Value>]

[WaterContent <Value>]

Any or all of the keyword-value pairs can be included on the command line. Valid values are:
  • The Ceiling <Value> is entered in Connect distance units. Valid values are 0 through 20 km.
  • Thickness <Value> is entered in Connect distance units. Valid values are 0 through 20 km.
  • Temperature <Value> is entered in degrees C. Valid values are -100.0 degC through 100.0 degC.
  • Density <Value> is entered in (Scenario mass units / km^3). Valid values are 0 through 100000000.0 g/km^3.
  • WaterContent <Value> is entered in (Scenario mass units / km^2). Valid values are 0 through 100000000.0 g/km^3.
TropoScint

[ComputeFade {On | Off}]

[ComputeDeepFade {On | Off}]

[FadeOutage <Percent>]

[Gradient <Percent>]

Any or all of the keyword-value pairs can be included on the command line. Valid values for <Percent> are 0.0 through 100.0.
CustomLossPlugin <PluginNumber> {On | Off | "<Filename>"} Up to three custom loss plugin scripts can be added. The <PluginNumber> specifies which script is being modified, valid values are 1, 2, 3. The script "<Filename>" must be defined before a plugin can be turned on or off. Each script file must have a different file name with different internal function names.
EarthTemperature <Temp> Specify the Earth Temperature. <Temp> is entered in Scenario temperature units and must be between 0 K and 1.0e006 K.
RainOutage <Outage> Valid values for <Outage> depend on the rain model selected.
InterferenceSelection <CommSysPath> Specify the truncated path of the CommSystem to be used in the Interference constraints.

Example

To use the ITU618-5 rain model in calculations for the RadarTest scenario, and set the RainOutage value:

Environment * RainModel On ITU_P618_5 78.6

Environment * RainOutage 0.03

To use the ITU-R P.676-3 absorption model in calculations for the RadarTest scenario:

Environment * Absorption On "ITU-R P.676-3" UseFastOn UseSeasonOff 300.0

To turn on computing of cloud and fog fade, set the cloud ceiling to 8000 m, and set the water content to 456.0 kg/km^2:

Environment * CloudFog Compute on ceiling 8000 watercontent 456

To turn on fade compute for the Tropospheric Scintillation model, and set the fade outage to 45%:

Environment * TropoScint ComputeFade on FadeOutage 45.0

To define the first Custom Loss Plugin and then turn it on:

Environment * CustomLossPlugin 1 "c:\Plugins\VB_absorbModel.vbs"

Environment * CustomLossPlugin 1 On

To set CommSystem1 to be used in the Interference constraints:

Environment * InterferenceSelection CommSystem/CommSystem1

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Comm

Radar

Scenarios

Deprecated Commands

Version

9.0

STK Programming Interface 11.0.1