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.
The SetConstraint command turns receiver, transmitter, or antenna constraints On and Off and also sets 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.
Noise Constraints
Noise Constraints are available for receivers only.
{ConstraintName} | Parameters |
---|---|
NoiseTemperature | {Off | Min <Value1> [|] Max <Value2>} [{NoiseOptions}] [ExcludeIntervals | IncludeIntervals]
where <Value1> and <Value2> are in Kelvin The following are valid {NoiseOptions}:
|
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 |
Refraction Constraints
The Refraction constraints are not valid in STK 8 and later. This includes SetConstraint {RefractedRange | RefractedElevation | RefractedLineOfSight}.
Use the Refraction command instead.
Basic Constraints
Basic constraints for receivers, transmitters and antennas vary according to the valid constraints for the parent object. Parent objects can be facilities and targets, 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.
Sun Constraints
Sun constraints for receivers, transmitters and antennas vary according to the valid constraints for the parent object. Parent objects can be facilities and targets, vehicles or sensors. Visit Connect help for the SetConstraint (Vehicles) and the SetConstraint (Sensor) commands for a complete list of valid sun constraints.
Temporal Constraints
The following Temporal constraint is available for receivers and transmitters:
{ConstraintName} | Parameters |
---|---|
ProcessDelay | {Off | Duration <Value1>} where <Value1> is entered in seconds between 0.0 and 86400.0 seconds. The Process Delay constraint will be turned off if the duration value is set to 0.0. |
Other Temporal constraints for receivers, transmitters and antennas vary according to the valid constraints for the parent object. Parent objects can be facilities and targets, vehicles or sensors. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of valid temporal constraints.
Advanced Constraints
Advanced constraints for receivers and transmitters vary according to the valid constraints for the parent object. Parent objects can be facilities and targets, vehicles or sensors. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of valid advanced constraints.
Zones Constraints
Zones constraints for receivers, transmitters and antennas vary according to the valid constraints for the parent object. Parent objects can be facilities and targets, vehicles or sensors. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of available zones constraints.
Targeting Constraints
Targeting constraints for receivers and transmitters vary according to the valid constraints for the parent object. Parent objects can be facilities and targets, vehicles or sensors. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of valid targeting constraints.
Vector Constraints
Vector constraints for receivers, transmitters and antennas vary according to the valid constraints for the parent object. Parent objects can be facilities and targets, vehicles or sensors. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of valid vector constraints.
Special Constraints
Special constraints for receivers, transmitters and antennas vary according to the valid constraints for the parent object. Parent objects can be facilities and targets, vehicles or sensors. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of valid special constraints.
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.
Examples
To set a maximum flux density of 10,000 dB(W/m squared) for the TestReceiver:
To set a CommPlugin constraint, using the specified script file:
Return message
Group membership
This command belongs to the following group(s):
Version
11.4