SetConstraint (Facility, Place & Target)
Set a constraint for a facility, place, or target
Syntax
SetConstraint <ObjectPath> {ConstraintName} <Parameters>
Related commands
Description
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.
Use the SetConstraint command to turn constraints On and Off for facilities, places, and targets and also to set parameters 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.
Basic constraints
The following Basic constraints are available for facilities, places, and targets:
| {ConstraintName} | <Parameters> |
|---|---|
| AzElMask | {On | Off} [ExcludeIntervals | IncludeIntervals] |
| ElevationAngle | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| ElevationRate | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| Lighting | {Off | DirectSun | PenumbraDirectSun | PenumbraUmbra | Penumbra | UmbraDirectSun | Umbra} |
| LineOfSight | {On | Off} [ExcludeIntervals | IncludeIntervals] |
| Range | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| RangeRate | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| TerrainMask | {On | Off} [ExcludeIntervals | IncludeIntervals] |
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.
Angle constraints
The following Angle constraints are valid for facilities, places, and targets. Enter all values in degrees.
| {ConstraintName} | <Parameters> |
|---|---|
| AngularRate | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| AzimuthAngle | {Off | Min <Value1> Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| AzimuthRate | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| CentralAngle | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| ElevationAngle | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| ElevationRate | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| ElevationRiseSet | {Off | Rise <Value1> [|] Set <Value2>} [ExcludeIntervals | IncludeIntervals] |
| GeoExclusion | {Off | Angle <Value1>} [ExcludeIntervals | IncludeIntervals] |
| ObjectExclusionAngle |
Enter Off All to turn off all ObjectExclusionAngle constraints for the parent object. Enter Off <TruncObjectPath> to turn off the specified object. Enter one or more of the following to add or modify ObjectExclusionAngle parameters:
You can add two or more <TruncObjectPath> objects to the same parent object. <Angle> is the minimum allowable exclusion angle in degrees, between -90.0 and 90.0. ModifyAll is the default and indicates that the angle and Exclude/Include Intervals parameters in the command affect all ObjectExclusionAngle constraints for all objects, not just the object(s) specified in the command. ModifySpecified applies the parameters only to the object(s) in the command. |
| TerrainGrazingAngle | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
Central Body constraints
The following Central Body constraints are valid for facilities, places, and targets:
| {ConstraintName} | <Parameters> |
|---|---|
| CbObstruction | {<CbName> ...} [ExcludeIntervals | IncludeIntervals]
For the CbObstruction constraint, you can enter one or more values for <CbName>. |
| LOSCbExclusion | Off {<CbName>}
<CbName> <Angle> [ExcludeIntervals | IncludeIntervals]
|
| LOSLunarExclusion | {Off | <Value1>} [ExcludeIntervals | IncludeIntervals] |
| LOSSunExclusion | {Off | <Value1>} [ExcludeIntervals | IncludeIntervals] |
| LOSSunIlluminationAngle | {Off | Min <Value1> Max <Value2>} [ExcludeIntervals | IncludeIntervals]
You must enter both a Min and Max value when enabling the LOSSunIlluminationAngle constraint. |
| LunarElevationAngle | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| SunElevationAngle | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
Geometry constraints
The following Geometry constraints are valid for facilities, places, and targets:
| {ConstraintName} | <Parameters> |
|---|---|
| 3DTilesMask | {On | Off} [ExcludeIntervals | IncludeIntervals] |
| Altitude | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| CentralDistance | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| GroundSampleDistance | {Off | Min <Value1> [|] Max <Value2>}
The GroundSampleDistance constraint applies to accesses where the other object is a sensor or child of a sensor. |
| HeightAboveHorizon | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| PropagationDelay | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| Range | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
| RangeRate | {Off | Min <Value1> [|] Max <Value2>} [ExcludeIntervals | IncludeIntervals] |
Analysis Workbench constraints
Analysis Workbench constraints for facilities, places, and targets are identical to that of vehicles. See the Connect help for the SetConstraint (Vehicles) command.
Plugin constraints
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.
Multifunction Radar and Multifunction Radar Jamming constraints
Multifunction Radar and Multifunction Radar Jamming 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 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.
Radar SearchTrack and Radar SearchTrack Jamming constraints
Radar SearchTrack and Radar SearchTrack Jamming 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 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 facilities, places, and targets 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.
Temporal 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.
Examples
To set the Lighting constraint so that access to the DC facility is only valid while the facility is in full sunlight:
Examples
Turn off all ObjectExclusionAngle constraints for Facility1:
Add Satellite1, Satellite212, and Satellite2 as Exclusion Objects, and set angle to 23.5 degrees:
Set the angle and Include Intervals for all Object Exclusion Angle constraints on Facility1:
Return message
Group membership
This command belongs to the following group(s):
Version
12.9