Set a constraint for a facility, place or target
SetConstraint <ObjectPath> {ConstraintName} <Parameters>
Warning: Caution should be exercised 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 constraints On and Off for facilities, places and targets, and also sets parameters for the constraints. The following Tables list valid values for {ConstraintName} as well as the parameters accepted for each. Only one constraint can be set with each SetConstraint command. All angle, latitude and longitude input values are entered in degrees.
Many of the basic constraints for facilities, places and targets are identical to that of vehicles. Visit Connect help for the SetConstraint (Vehicles) commands for a complete list of valid basic constraints.
The following sensor specific constraint are available in addition to the constraints available for vehicles:
| {ConstraintName} | <Parameters> |
|---|---|
| AzimuthRate | {Off | Min <Value> [|] Max <Value>} [ExcludeIntervals | IncludeIntervals] |
| ElevationRate | {Off | Min <Value> [|] Max <Value>} [ExcludeIntervals | IncludeIntervals] |
| AzElMask | {On | Off} |
The ExcludeIntervals option allows 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.
Sun constraints for facilities, places and targets are identical to that of vehicles. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of valid sun constraints.
Temporal constraints for facilities, places and targets are identical to that of vehicles. Visit Connect help for the SetConstraint (Vehicles) commands for a complete list of valid temporal constraints.
Vector constraints for facilities, places and targets are identical to that of vehicles. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of valid vector constraints.
The following special constraints are valid for facilities, places and targets:
| {ConstraintName} | <Parameters> |
|---|---|
| GeoExclusion | {Off | On | <Value>} [ExcludeIntervals | IncludeIntervals], where <Value> entered in degrees, between 0 and 180 degrees. |
| HeightAboveHorizon | {Off | Min <Value> [|] Max <Value>} [ExcludeIntervals | IncludeIntervals] |
| TerrainGrazingAngle | {Off | Min <Value> [|] Max <Value>} [ExcludeIntervals | IncludeIntervals] |
| GroundSampleDistance | {Off | Min <Value> [|] Max <Value>} |
| ObjectExclusionAngle | {Off | <TruncObjectPath> <Value> [ExcludeIntervals | IncludeIntervals]}, where <Value> is the minimum allowable exclusion angle in degrees and is only specified if a truncated object path is given. A truncated object path is the full name of the object without the scenario name in front of it. |
Warning: The GroundSampleDistance constraint is only applied when the other object in the access computation is a sensor.
Plugin constraints for facilities, places and targets are identical to that of vehicles. Visit Connect help for the SetConstraint (Vehicles) command for help setting plugin constraints.
Search/Track constraints for facilities, places and targets are identical to that of radar. Visit Connect help for the SetConstraint (Radar) command for a complete list of valid Search/Track constraints. These constraints will only have an effect on an access if one of the access objects is a radar. This allows you to constrain a radar access using the target object.
SAR constraints for facilities, places and targets are identical to that of radar. Visit Connect help for the SetConstraint (Radar) command for a complete list of valid SAR constraints. These constraints will only have an effect on an access if one of the access objects is a radar. This allows you to constrain a radar access using the target object.
To set the Sun constraint so that access to the DC facility is only valid while the facility is in full sunlight:
SetConstraint */Facility/DC Lighting DirectSun
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
10
STK Programming Interface 11.0.1