SetConstraint (Comm)
Set a constraint for a receiver, transmitter, or antenna
Syntax
SetConstraint <ObjectPath> {ConstraintName} <Parameters>
Related commands
Description
You should exercise caution when turning a constraint Off, in that any previously set constraint values may be lost. These cannot be recovered when the constraint is subsequently turned On.
Use the SetConstraint command to turn receiver, transmitter, and antenna constraints On and Off and also set values for the constraints. The following tables list valid values for {ConstraintName} as well as the parameters accepted for each. You can only set one constraint with each SetConstraint command. Enter all angle, latitude, and longitude input values in degrees.
Comm Constraints
The following Comm constraints are valid for receivers and transmitters:
| {ConstraintName} | Parameters |
|---|---|
| RcvdIsotropicPower | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are in dBW |
| PowerAtReceiverInput | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are in dBW |
| DopplerShift | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are in GHz |
| Frequency | {Off | Min <Value1> | Max <Value2> | Band <Value3>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are in GHz and <Value3> is L, S, C, X, KU, KA, K, Q, V, or custom |
| C/N | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dB |
| FluxDensity | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dBW/m^2 |
| SpectralFluxDensity | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dBW/m^2Hz |
| C/No | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dB*Hz |
| Eb/No | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dB |
| BitErrorRate | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| PolRelAngle | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in degrees |
| LinkEIRP | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dBW |
| LinkMargin | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| G/T | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dB/K |
The following Comm constraints are valid for receivers only:
| {ConstraintName} | Parameters |
|---|---|
| CommPlugin | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] "<ConstraintFileName>"
<Value1> and <Value2> are entered in dB. <ConstraintFileName> is the script file, created in VBScript or MATLAB, that defines the constraint. |
The ExcludeIntervals option enables you to exclude the time intervals during which the constraint is satisfied. Specifying IncludeIntervals turns off this option and the times during which the constraint is satisfied will be used.
RF Loss constraints
RF Loss constraints are available for both transmitters and receivers except for NoiseTemperature, which is only available for receivers.
Except for NoiseTemperature, enter all maximum and minimum values for RF Loss constraints in dB.
| {ConstraintName} | Parameters |
|---|---|
| AtmosLoss | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| CloudsFogLoss | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| FreeSpaceLoss | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| IonoFadingLoss | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| NoiseTemperature | {Off | Min <Value1> [|] Max <Value2>} [{NoiseOptions}] [ExcludeIntervals | IncludeIntervals]
where <Value1> and <Value2> are in Kelvin The following are valid {NoiseOptions}:
|
| PropLoss | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| RainLoss | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| TropoScintillLoss | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| UrbanTerresLoss | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| UserCustomALoss | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| UserCustomBLoss | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| UserCustomCLoss | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
Interference Constraints
The Interference constraints are valid for receivers and transmitters:
| {ConstraintName} | Parameters |
|---|---|
| PowerFluxDensity | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dBW/m^2 |
| C/No+Io | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dB*Hz |
| J/S | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dB |
| C/N+I | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dB |
| C/I | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dB |
| TotalRcvdRFPower | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dBW |
| TotalPwrAtRcvrInput | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dBW |
| Eb/No+Io | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dB |
| BER+I | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| DeltaT/T | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals], where <Value1> and <Value2> are entered in dB |
Basic constraints
Basic constraints for receivers, transmitters, and antennas vary according to the valid constraints for the parent object. Parent objects can be facilities, places, vehicles, or sensors. Visit Connect help for the SetConstraint (Facility, Place & Target), SetConstraint (Sensor) or the SetConstraint (Vehicles) commands for a complete list of valid Basic constraints.
Analysis Workbench constraints
Analysis Workbench constraints for receivers, transmitters, and antennas are the same as for constraints for the parent object. Parent objects can be facilities, places, vehicles, or sensors. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of valid Analysis Workbench constraints.
Angle constraints
Angle constraints for receivers, transmitters, and antennas vary according to the valid constraints for the parent object. Parent objects can be facilities, places, vehicles, or sensors. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of valid Angle constraints.
Central Body constraints
Central Body constraints for receivers, transmitters, and antennas vary according to the valid constraints for the parent object. Parent objects can be facilities, places, vehicles, or sensors. Visit Connect help for the SetConstraint (Vehicles) and the SetConstraint (Sensor) commands for a complete list of valid Central Body constraints.
Geometry constraints
Geometry constraints for receivers, transmitters, and antennas vary according to the valid constraints for the parent object. Parent objects can be facilities, places, vehicles, or sensors. Visit Connect help for the SetConstraint (Facility, Place & Target), SetConstraint (Sensor) or the SetConstraint (Vehicles) commands for a complete list of valid Geometry constraints.
Multifunction Radar and Multifunction Radar Jamming constraints
Multifunction Radar and Multifunction Radar Jamming constraints for receivers and transmitters are identical to that of radar. Visit Connect help for the SetConstraint (Radar) command for a complete list of valid Multifunction Radar and Multifunction Radar Jamming constraints. These constraints will only have an effect on an access if one of the access objects is a radar. This enables you to constrain a radar access using the target object.
Plugin constraints
Plugin constraints for receivers, transmitters and antennas are identical to that of vehicles. Visit Connect help for the SetConstraint (Vehicles) command for help setting Plugin constraints.
Radar SearchTrack and Radar SearchTrack Jamming constraints
Radar SearchTrack and Radar SearchTrack Jamming constraints for receivers and transmitters are identical to that of radar. Visit Connect help for the SetConstraint (Radar) command for a complete list of valid Radar SearchTrack and Radar SearchTrack Jamming constraints. These constraints will only have an effect on an access if one of the access objects is a radar. This enables you to constrain a radar access using the target object.
Radar SAR and Radar SAR Jamming constraints
Radar SAR and Radar SAR Jamming constraints for receivers and transmitters are identical to that of radar. Visit Connect help for the SetConstraint (Radar) command for a complete list of valid Radar SAR and Radar SAR Jamming constraints. These constraints will only have an effect on an access if one of the access objects is a radar. This enables you to constrain a radar access using the target object.
SEET constraints
SEET constraints for receivers, transmitters, and antennas are identical to that of satellites. Visit Connect help for the SetConstraint (SEET) command for a complete list of valid SEET constraints.
Temporal constraints
Temporal constraints for receivers, transmitters and antennas are the same as for vehicles. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of valid Temporal constraints.
Zones constraints
Zones constraints for receivers, transmitters, and antennas are the same as for the parent object. Parent objects can be facilities, places, vehicles, or sensors. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of available Zones constraints.
Examples
To set a maximum flux density of 10,000 dB(W/m squared) for the TestReceiver:
To set a CommPlugin constraint using a specified script file:
Return message
Group membership
This command belongs to the following group(s):
Version
12.9