Description | Example | Return Message | Group

Refraction

Set refraction properties for sensor, radar, receiver, transmitter or antenna.

Syntax

Refraction <ObjectPath> {Options}

Description

Use the Refraction command to set refraction model properties for a Sensor, Radar, Receiver, Transmitter or Antenna. The following table describes the valid {Options}.

{Options} Description
UseInAccess {True | False} Set to True to use Refraction in access computations.
Model {ModelType} <Parameters> The {ModelType} can be:
  • "Effective Radius Method"
  • "ITU-R P.834-4"
  • "SCF Method"

The following table describes the <Parameters> for each {ModelType}:

{ModelType} <Parameters> Description
"Effective Radius Method" EffectiveRadiusFactor <Value> Valid <Value> is between 0.1 and 100.0, this is a unitless value.
RefractionCeiling <Value> Valid <Value> is between 0.0 and 1.0e+20, entered in Connect distance units.
MaxTargetAltitude <Value> Valid <Value> is between 0.0 and 1.0e+20, entered in Connect distance units.
ExtrapolateAboveMaxAltitude {True | False}
"ITU-R P.834-4" RefractionCeiling <Value> Valid <Value> is between 0.0 and 1.0e+20, entered in Connect distance units.
AtmosphereAltitude <Value> Valid <Value> is between 0.0 and 1.0e+20, entered in Connect distance units.
KneeBendFactor <Value> Valid <Value> is between 0.0 and 1.0, this is a unitless value.
"SCF Method" RefractionCeiling <Value> Valid <Value> is between 0.0 and 1.0e+20, entered in Connect distance units.
AtmosphereAltitude <Value> Valid <Value> is between 0.0 and 1.0e+20, entered in Connect distance units.
KneeBendFactor <Value> Valid <Value> is between 0.0 and 1.0, this is a unitless value.
MinTargetAltitude <Value> Valid <Value> is between 0.0 and 1.0e+20, entered in Connect distance units.
ExtrapolateBelowMinAltitude {True | False}
UseRefractionIndex {True | False}
RefractionIndex <Value> This option is valid only if UseRefractionIndex is set to True. Valid <Value> is between 1.0 and 10000.0, this is a unitless value.
C0 <C0> C1 <C1> C2 <C2> C3 <C3> C4 <C4> C5 <C5> C6 <C6> C7 <C7> C8 <C8> C9 <C9> C10 <C10> Enter the Refraction polynomial coefficients. The Coefficients are only valid if UseRefractionIndex is set to False. Any or all of the values can be entered.

Valid <C0> is between 1.0 and 10000.0. Valid value for all remaing coefficient values are between -1.0e+20 and 1.0e+20.

Example

To use the refraction values in any access computations for Radar1:

Refraction */Satellite/Satellite1/Radar/Radar1 UseInAccess True

To set the refraction model of Transmitter1 to "Effective Radius Method":

Refraction */Satellite/Satellite1/Transmitter/Transmitter1 Model "Effective Radius Method" EffectiveRadiusFactor 1.5 RefractionCeiling 8000 ExtrapolateAboveMaxAltitude True

To set the refraction model of Transmitter1 to ITU:

Refraction */Satellite/Satellite1/Transmitter/Transmitter1 Model "ITU-R P.834-4" RefractionCeiling 8000 AtmosphereAltitude 9000 KneeBendFactor 0.4

To set the refraction model of Transmitter1 to SCF:

Refraction */Satellite/Satellite1/Transmitter/Transmitter1 Model "SCF Method" UseRefractionIndex True RefractionIndex 400 AtmosphereAltitude 9000.0 KneeBendFactor 0.5 ExtrapolateBelowMinAltitude True

To set the refraction model of Transmitter1 to SCF and use the refraction polynomial:

Refraction */Satellite/Satellite1/Transmitter/Transmitter1 Model "SCF Method" UseRefractionIndex False AtmosphereAltitude 9000.0 KneeBendFactor 0.7 ExtrapolateBelowMinAltitude True C0 400 C1 600 C2 300.0354 C3 120 C4 325.123 C5 310 C6 555 C7 120 C8 324 C9 5000 C10 245

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Comm

Radar

Sensors

Version

8.0

STK Programming Interface 11.0.1