Set basic properties of a receiver (Deprecated Command)
Comm <RcObjectPath> Define RcvrModel {ModelType} <Parameters>
Note: This command was deprecated in STK 9, it should no longer be used. This command has been replaced by the Receiver 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 Receiver command, see Transitioning to the New Receiver Connect Format.
The Comm Define command allows you to define the basic properties of the specified receiver. {ModelType} can be Simple, Medium, Complex, Multibeam, Laser, Cable or Plugin.
Use the Simple model type if you don't have all the information necessary to model the receiver at a detailed level. This is a common occurrence during the systems engineering process.
Use the Medium model type if you need a little more flexibility than that provided by the Simple model. Use the Complex model to specify a particular antenna type, whether it is one of the predefined antennas or an antenna defined in an external file. Use the Multibeam model to specify a receiver configured with multiple antenna beams.
Use the Laser model to specify a receiver to model free space laser communications.
Use the Cable model to specify a receiver that is physically connected to the transmitter by some type of "fixed line medium," such as wire, coaxial cable, twisted-pair cable, CAT-5, fiber optic silica, etc.
Note: The Cable {ModelType} is available only for a receiver whose parent object is a facility or target.
Use the Plugin model to define a receiver using an external script file, such as MATLAB, VBScript or Perl.
Hint: Once you set the basic parameters for a Receiver model using this command, use the commands listed in the Related Commands list above and Graphics (Comm) command to further define the receiver.
The following tables describe the parameters for the Receiver Models. At least one <Parameter> Keyword and Value must be included on a Comm Define command line.
| <Parameter> | Description |
|---|---|
| gOverT <Value> | gOverT is a numeric value indicating the receiver gain divided by the system noise temperature. The value is entered in dB/K, and must be between -2890.0 and 2890.0 |
| Bandwidth {Auto | <Value>} | Enter Auto to select autoscale mode or enter a numeric value in MHz. The value must be between 1e-9 to 1000000000 MHz |
| Frequency {Auto | <Value>} | Enter Auto to select autoscale mode, or enter a numeric value in Scenario Frequency units. The value must be between 0.0 and 1.0e15 Hz |
| <Parameter> | Description |
|---|---|
| Gain <Value> | Gain is a numeric value specifying the receiver antenna's isotropic gain. The value is entered in dB, and must be between -2890.0 and 2890.0 |
| Bandwidth {Auto | <Value>} | Enter Auto to select autoscale mode or enter a numeric value in MHz. The value must be between 1e-9 to 1000000000 MHz |
| Frequency {Auto | <Value>} | Enter Auto to select autoscale mode, or enter a numeric value in Scenario Frequency units. The value must be between 0.0 and 1.0e15 Hz |
| <Parameter> | Description |
|---|---|
| Bandwidth {Auto | <Value>} | Enter Auto to select autoscale mode or enter a numeric value in MHz. The value must be between 1e-9 to 1000000000 MHz |
| Frequency {Auto | <Value>} | Enter Auto to select autoscale mode, or enter a numeric value in Scenario Frequency units. The value must be between 0.0 and 1.0e15 Hz |
To set the properties of the Multibeam receiver enter any of the {RcvrParams} described in this table:
s| {RcvrParams} | Description |
|---|---|
| Frequency {Auto | NotAuto} | Enter Auto to select AutoTrack mode, or NotAuto to turn off AutoTrack mode. |
| Bandwidth {Auto | <Value>} | Enter Auto to select AutoScale mode; or enter a <Value> in MHz, between 1e-9 and 1000000000.0 MHz |
To Add, Modify or delete individual beams use this format:
{Add | Modify | Delete} <BeamID> {BeamParameters}Where {BeamParameters} are described in the table below:
| {BeamParameter} | Description |
|---|---|
| Power <Value> | Power is a numeric value indicating the power of the beam. The value is entered in Scenario Power units and must be between -2890.0 and -2890.0 dBW |
| Frequency <Value> | Enter a numeric value in Scenario Frequency units. The value must be between 0.0 and 1.0e11 Hz |
| Active {Yes | No} | Enter Yes to indicate that the beam is Active. |
| <Parameter> | Description |
|---|---|
| Gain <Value> | Gain is a numeric value specifying the receiver antenna's isotropic gain. The value is entered in dB, and must be between -2890.0 and 2890.0 |
| Bandwidth {Auto | <Value>} | Enter Auto to select autoscale mode or enter a numeric value in MHz. The value must be between 1e-6 to 1000000 MHz |
| Frequency {Auto | <Value>} | Enter Auto to select autoscale mode, or enter a numeric value in Scenario Frequency units. The value must be between 1.0e12 and 1.0e17 Hz |
| OpticsArea <Value> | The value is entered in Scenario Small Distance units squared, and must be between 1e-6 and 10000 m**2 |
| OpticsEfficiency <Value> | The value is a percentage and must be between 0.0 and 100.0 |
| DetectorArea <Value> | The value is entered in Scenario Small Distance units squared, and must be between 1e-6 and 10000 m**2 |
| DetectorEfficiency <Value> | The value is a percentage and must be between 0.0 and 100.0 |
| DetectorDarkCurrent <Value> | The value must be between 0.0 and 0.001 |
| DetectorNoiseFactor <Value> | The value is entered in dB and must be between -2890.0 and 2890.0 dB |
| DetectorGain <Value> | The value is entered in dB and must be between -2890.0 and 2890.0 dB |
| DetectorNoiseTemp <Value> | The value is entered in degK and must be between -273.0 and 10000.0 degK |
| DetectorLoadImpedance <Value> | The value must be between 1e-12 and 1000000000000.0 |
| AtmLoss {AtmOption} <Parameters> | Select and configure an atmosphere loss model. Valid values for {AtmOption} <Parameters> are described in the next table. |
| {AtmOption} <Parameter> | Description |
|---|---|
| Enable <Value> | Valid values are 0 and 1, Enter 1 to enable the model, 0 to disable. |
| NumLayers <Value> | Enter the desired number of layers. Valid values are greater or equal to 1. |
| Layer <Value> {LayerOptions} | Set options for a specific layer. <Value> must indicate an existing layer (as specified by the NumLayers option). Valid values for {LayerOptions} are described in the next table. |
| {LayerOptions} | Description |
|---|---|
| Top <Value> | Entered in meters, valid values are between 0 and 1.0e5. |
| Coeff <Value> | Entered in 1/meters, valid values are between -1.0e25 and 1.0e25. |
| <Parameter> | Description |
|---|---|
| BER <Value> | A numeric value between 1.0e-25 to 0.5 |
| ExcessCableRatio <Value> | A numeric value between 0.0 to 1000.0 |
| PropSpeedRatio <Value> | A numeric value between 0.0 to 1.0 |
| <Parameter> | Description |
|---|---|
| "<Filename>" | Enter the full file path and name to be used to define the receiver. The file is an external script, such as MATLAB, VBScript and Perl scripts, that defines the receiver. |
To set the basic properties of the GndRcvr receiver so that the simple model is used with a g/T of 6.0 dB/K, an auto-scale bandwidth:
Comm */Facility/Customer/Receiver/GndRcvr Define RcvrModel Simple gOverT 6.0 Bandwidth AUTO
To define a multibeam receiver, with a default Beam001, and set the receiver's frequency and bandwidth:
Comm */Satellite/GEO/Receiver/Uplink Define RcvrModel MultiBeam Frequency Auto Bandwidth Auto
To add an active single beam at of 13.01 dBW at 16 GHz:
Comm */Satellite/GEO/Receiver/Uplink Define RcvrModel MultiBeam Add Beam001 Frequency 16.0 Power 13.01 Active Yes
To add another beam to preexisting multibeam receiver with the same properties:
Comm */Satellite/GEO/Receiver/Uplink Define RcvrModel MultiBeam Add Beam002 Frequency 16.0 Power 13.01
To modify Beam002 to be at 17 GHz:
Comm */Satellite/GEO/Receiver/Uplink Define RcvrModel MultiBeam Modify Beam002 Frequency 17.0
To delete Beam002:
Comm */Satellite/GEO/Receiver/Uplink Define RcvrModel MultiBeam Delete Beam002
To define a complex receiver with bandwidth of 2 kHz (0.002 MHz):
Comm */Facility/West/Receiver/conrec1 Define RcvrModel Complex Bandwidth 0.002
To define a medium receiver with a gain value of 0.5 dB, autoscale the bandwidth, and autoscale the frequency:
Comm */Facility/West/Receiver/conrec1 Define RcvrModel Medium Gain 0.5 Bandwidth Auto Frequency Auto
To define a laser receiver with a gain value of 0.5 dB, autoscale the bandwidth, set optics area to 1.21 meters squared and optics effiency to 67%:
Comm */Facility/West/Receiver/conrec1 Define RcvrModel Laser Gain 0.5 Bandwidth Auto OpticsArea 1.21 OpticsEfficiency 67
To define the atmospheric loss model for a laser receiver:
Comm */Satellite/Satellite1//Receiver/Receiver1 Define RcvrModel Laser AtmLoss Enable 1
Comm */Satellite/Satellite1//Receiver/Receiver1 Define RcvrModel Laser AtmLoss NumLayers 4
Comm */Satellite/Satellite1//Receiver/Receiver1 Define RcvrModel Laser AtmLoss Layer 1 Top 1000 Coeff 2.51e-8 Layer 4 Top 90000 Coeff 2.54e-8
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
9.0
STK Programming Interface 11.0.1