Description | Example | Return message | Group

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.

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.

Basic Constraints

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} [ExcludeIntervals | IncludeIntervals]

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

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

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

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.

Resolution Constraints

{ConstraintName}<Parameters>
GroundSampleDistance{Off | Min <Value1> [|] Max <Value2>}

The GroundSampleDistance constraint applies to accesses where the other object is a sensor, or child of a sensor.

Special 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>}

The GroundSampleDistance constraint is only applied when the other object in the access computation is a sensor.

ObjectExclusionAngle
  • Off {All | <TruncObjectPath>}

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:

  • <TruncObjectPath>
  • <Angle>
  • {ExcludeIntervals | IncludeIntervals}

Multiple <TruncObjectPath> objects can be added to the same parent object.

<Angle> is the minimum allowable exclusion angle in degrees, between -90.0 and 90.0.

<Angle> and {ExcludeIntervals | IncludeIntervals} are applied to all ObjectExclusionAngle objects for the parent object.

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.

Search/Track 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

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.

Examples

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

Examples

Turn off all ObjectExclusionAngle constraints for Facility1:

SetConstraint */Facility/Facility1 ObjectExclusionAngle Off All

Add Satellite1, Satellite212, and Satellite2 as Exclusion Objects, and set angle to 23.5 degrees:

SetConstraint */Facility/Facility1 ObjectExclusionAngle Satellite/Satellite1
SetConstraint */Facility/Facility1 ObjectExclusionAngle Satellite/Satellite212 23.5 Satellite/Satellite2

Set the angle and Include Intervals for all Object Exclusion Angle constraints on Facility1:

SetConstraint */Facility/Facility1 ObjectExclusionAngle IncludeIntervals 13.2

Return message

Group membership

This command belongs to the following group(s):

Facilities, Places & Targets

Version

11.5