Description | Example | Return Message | Group

Comm GainLoss

Create a list of pre-receive or pre-demodulation gains and losses for a receiver or post-transmit gains and losses for a transmitter that will be added to the link equation (Deprecated Command)

Syntax

Comm <ObjectPath> GainLoss [{PreReceive | PreDemod}] {ListOptions}

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

Receiver, Transmitter

Description

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

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 see Transitioning to the New Transmitter Format and Transitioning to the New Receiver Format.

The Comm GainLoss command creates a list of pre-receive or pre-demodulation gains and losses for a receiver or post-transmit gains and losses to a transmitter. During communications link analysis, it is often necessary to model gains and losses that affect the link but aren't defined using built-in analytical models. STK allows you to model these by specifying miscellaneous gains and losses that can be added to the link equation.

If PreReceive is entered create a list of gains and losses that occur before reaching the receive antenna.

If PreDemod is entered create a list of gains and losses that occur after the output of the receiver antenna but before that data is demodulated.

If <ObjectPath> is a Transmitter then all values automatically replace any existing values in the post-transmit list.

{ListOption}
<Label> <Value> [<Label2> <Value2>...] Specify <Label> <Value> pairs representing gains and losses to be added to the link equation for the list specified. Any number of <Label> <Value> pairs can be specified at one time. All <Values> are entered in decibels.
ClearAll Clear all values from the specified {ListOption}.

Note: Each time you create a new list of gains and losses using any, existing gains and losses in the list are automatically replaced with the new values specified.

Example

To add a -1.0 dB pre-receive point loss to the GndRcvr receiver attached to the Customer facility:

Comm */Facility/Customer/Receiver/GndRcvr GainLoss PreReceive PointLoss -1.0

To add a 1.0 dB post-transmit point gain to the Downlink transmitter attached to the GEO satellite:

Comm */Satellite/GEO/Transmitter/Downlink GainLoss PointGain -1.0

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Comm

Deprecated Commands

Version

9.0

STK Programming Interface 11.0.1