Description | Example | Return message | Group

SetConstraint (Sensor)

Set a constraint for a sensor

Syntax

SetConstraint <SensorObjectPath> {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 for sensors On and Off and also to set values for these constraints. The following tables list valid values for {ConstraintName} as well as the values 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

Basic constraints for sensors vary according to the valid constraints for the parent object. Parent objects can be facilities, places, or vehicles. Visit Connect help for the SetConstraint (Facility, Place & Target) or the SetConstraint (Vehicles) commands for a list of valid Basic constraints for these parent objects.

In addition to the constraints available for parent objects, the table below lists sensor-specific Basic constraints.

{ConstraintName}<Parameters>
AzElMask{On | Off} [ExcludeIntervals | IncludeIntervals]
FieldOfView{On | Off} [ExcludeIntervals | IncludeIntervals]
SensorAzElMask{On | Off} [ExcludeIntervals | IncludeIntervals]

Angle constraints

Angle constraints for sensors vary according to the valid constraints for the parent object. Parent objects can be facilities, places, or vehicles. Visit Connect help for the SetConstraint (Facility, Place & Target) or the SetConstraint (Vehicles) commands for a complete list of valid Angle constraints.

In addition to the constraints available for parent objects, the table below lists sensor-specific Angle constraints.

{ConstraintName}<Parameters>
AngleOffBoresight{On | Off} [ExcludeIntervals | IncludeIntervals]
AngleOffBoresightRate{On | Off} [ExcludeIntervals | IncludeIntervals]
BoresightGrazingAngle{On | Off} [ExcludeIntervals | IncludeIntervals]

Central Body constraints

Central Body constraints for sensors vary according to the valid constraints for the parent object. Parent objects can be facilities, places, or vehicles. Visit Connect help for the SetConstraint (Facility, Place & Target) or SetConstraint (Vehicles) command for a list of valid Central Body constraints for these parent objects. In addition to the constraints available for parent objects, the table below lists sensor-specific Central Body constraints.

{ConstraintName}<Parameters>
BSCbExclusion

Off {<CbName>}

  • Off <CbName> turns off all BSCbExclusion constraints with <CbName>.
  • Off by itself turns off all BSCbExclusion constraints.

<CbName> <Angle> [ExcludeIntervals | IncludeIntervals]

  • Modifies all existing BSCbExclusion constraints with <CbName> if they exist or adds a new BSCbExclusion constraint with <CbName>.
BSLunarExclusion{Off | <Value1>}
BSSunExclusion{Off | <Value1>}
FOVSunSpecularExclusion{Off | <Value1>}

Analysis Workbench constraints

Analysis Workbench constraints for sensors vary according to the valid constraints for the parent object. Parent objects can be facilities, places, or vehicles. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of valid Analysis Workbench constraints.

EOIR constraints

EOIR constraints are available for sensors defined as EOIR sensors. Visit Connect help for the SetConstraint (EOIR) commands for a complete list of valid EOIR constraints.

Geometry constraints

Geometry constraints for sensors vary according to the valid constraints for the parent object. Parent objects can be facilities, places, or vehicles. Visit Connect help for the SetConstraint (Facility, Place & Target) and 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 vehicles 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 sensors 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 vehicles 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 vehicles 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 sensors vary according to the valid constraints for the parent object. Parent objects can be facilities, places, or vehicles. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of valid Temporal constraints.

Zones constraints

Zones constraints for sensors vary according to the valid constraints for the parent object. Vehicles are the only parent objects that have zones constraints available to them. Visit Connect help for the SetConstraint (Vehicles) command for a complete list of available Zones constraints.

Examples

To set the maximum cross-track range for the Horizon sensor on the Shuttle to 200000 m:

SetConstraint */Satellite/Shuttle CrossTrackRange Max 200000

Examples

To turn off all BSCbExclusion constraints with central body set to Mars:

SetConstraint */Satellite/Satellite1 BSCbExclusion Off Mars

To add an BSCbExclusion constraint with central body set to Mars, or modify an existing BSCbExclusion constraint with central body set to Mars, such that the exclusion angle is 15 degrees:

SetConstraint */Satellite/Satellite1 BSCbExclusion Mars 15

Return message

Group membership

This command belongs to the following group(s):

Sensors

Version

12.9