Receiver

Set, add and remove properties for a receiver.

Syntax

Receiver <RcObjectPath> {Options} <AttributePath> [<Value>] [<Unit>]

Related commands

• Receiver_RM
• Environment

Description

The Receiver command allows you to define the basic properties of the specified receiver. This command replaces the Comm Define (Receiver) command, which has been deprecated.

Valid values for {Options} are SetValue, AddItem, RemoveItem, AddObject, RemoveObject.

The <AttributePath> specifies the attribute to be set, added to or removed from. Use the Receiver_RM GetValue command to return a list of attributes, or the properties and choices for a specific attribute.

The <Value> parameter is entered if {Options} is SetValue, RemoveItem, AddObject, or RemoveObject.

The following table further describes the {Options}.

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

To set the rain model options for receivers, you must first turn on the UseRainModel attribute using the Environment command.

Examples

Use the Receiver_RM GetValue command to get the current Receiver values:

UserComment = STK Receiver Object Model = Simple_Receiver_Model Model.UserComment = Simple model of a receiver Model.AutoSelectDemodulator = true Model.UseFilter = false Model.AutoScaleBandwidth = true Model.PreReceiveGainsLosses.GainLossList (Empty List) Model.PreReceiveGainsLosses.TotalGain = 1.00000000 units (Read-only) Model.PreDemodGainsLosses.GainLossList (Empty List) Model.PreDemodGainsLosses.TotalGain = 1.00000000 units (Read-only) Model.EnableLinkMargin = false Model.GOverT = 100.00000000 units*K^-1 Model.UsePolarization = false Model.FrequencyAutoTracking = true Model.AntennaGain = 1.00000000 units (Read-only)

Set the Receiver Model.UseFilter attribute to true:

Use the Receiver_RM GetValue command to get the values of the Filter:

Model.Filter = Butterworth Model.Filter.UserComment = General form of nth order Butterworth filter with fat passband and stopband regions Model.Filter.LowerBandwidthLimit = -20000000.00000000 Hz Model.Filter.UpperBandwidthLimit = 20000000.00000000 Hz Model.Filter.InsertionLoss = 1.00000000 units Model.Filter.Bandwidth = 40000000.00000000 Hz (Read-only) Model.Filter.Order = 4 Model.Filter.CutoffFrequency = 10000000.00000000 Hz

Set the upper and lower bandwidth limit values for the filter:

Examples

To set the Receiver's Model to Laser, and then modify the Propagation Loss Model attributes:

First use the Receiver_RM GetValue command, specifying the Model attribute with the Choices option to get the names of available Receiver models:

Cable_Receiver_Model Complex_Receiver_Model Laser_Receiver_Model Medium_Receiver_Model Multibeam_Receiver_Model Script_Plugin_Laser_Receiver_Model Script_Plugin_RF_Receiver_Model Simple_Receiver_Model

Use the Receiver SetValue command to set the model:

To enable the Receiver's Propagation Loss Model:

To add three Layers to the Receiver's Propagation Loss Model, to make a total of 4 layers (note: one layer has been added by default):

Use the Receiver_RM GetValue command, specifying the Model.PropagationLossModel attribute:

Model.PropagationLossModel = Beer-Bouguer-Lambert_Law Model.PropagationLossModel.UserComment = Model atmospheric loss for laser receivers using the Beer-Bouguer-Lambert Law Model.PropagationLossModel.LayerList[0].LayerNum = 4 (Read-only) Model.PropagationLossModel.LayerList[0].LayerTop = 100000.00000000 m (Read-only) Model.PropagationLossModel.LayerList[0].ExtinctionCoefficient = 0 m^-1 Model.PropagationLossModel.LayerList[1].LayerNum = 3 (Read-only) Model.PropagationLossModel.LayerList[1].LayerTop = 75000.00000000 m (Read-only) Model.PropagationLossModel.LayerList[1].ExtinctionCoefficient = 0 m^-1 Model.PropagationLossModel.LayerList[2].LayerNum = 2 (Read-only) Model.PropagationLossModel.LayerList[2].LayerTop = 50000.00000000 m (Read-only) Model.PropagationLossModel.LayerList[2].ExtinctionCoefficient = 0 m^-1 Model.PropagationLossModel.LayerList[3].LayerNum = 1 (Read-only) Model.PropagationLossModel.LayerList[3].LayerTop = 25000.00000000 m (Read-only) Model.PropagationLossModel.LayerList[3].ExtinctionCoefficient = 0 m^-1 Model.PropagationLossModel.EnableEvenlySpacedHeights = true Model.PropagationLossModel.MaxLayerHeight = 100000.00000000 m Model.PropagationLossModel.MinLayerHeight = 0 m

To set the Coefficient values for Layer 1 and Layer 4 the list is accessed via an index, and begins at 0. Note that the layers are in reverse order. Layer 4 is at index 0, Layer 1 is at index 3.

To remove the third item from the LayerList (index 2):

Examples

On a Complex Receiver, whose Antenna is defined as Phased Array, enable and add two objects to the BeamDirectionProvider list:

To see the BeamDirectionProvider list:

Model.Antenna.AntennaControl.BeamDirectionProvider = Object Model.Antenna.AntennaControl.BeamDirectionProvider.Enabled = true Model.Antenna.AntennaControl.BeamDirectionProvider.Directions[0] = Facility/Facility1/Radar/Radar2 Model.Antenna.AntennaControl.BeamDirectionProvider.Directions[1] = Satellite/Satellite1/Radar/Radar1

To get the size of the Antenna's BeamDirectionProvider.Directions list:

Model.Antenna.AntennaControl.BeamDirectionProvider.Directions:Size = 2

To remove the first object from the BeamDirectionProvider.Directions list:

To get the size of the Antenna's BeamDirectionProvider.Directions list:

Model.Antenna.AntennaControl.BeamDirectionProvider.Directions:Size = 1

Return message

Group membership

This command belongs to the following group(s):

Comm

Version

9.0