Description | Example | Return Message | Group

SetConstraint (Radar)

Set constraints for a radar system

Syntax

SetConstraint <RdrObjectPath> {ConstraintName} <Parameters>

Related Commands

SetConstraintOptions

Description

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 radar 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. Only one constraint can be set with each SetConstraint command. All angle, latitude and longitude input values are entered in degrees.

SAR Constraints

Note: The SAR constraints will not be applied unless the SAR mode is enabled, see the Radar command to set the Model.Mode attribute to "SAR".

Note: SAR Constraints are also available for GroundVehicle, Ship, Facility, Place and Target objects.

{ConstraintName}	<Parameters>
SARSNR	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SARSigmaN	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SARAzRes	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are greater or equal to 0.0.
SARCNR	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SARPTCR	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SARAreaRate	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in distance squared/time, greater or equal to 0.0.
SARSCR	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SARIntTime	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in seconds, greater or equal to 0.0.
SARImageArea	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in meters squared, greater or equal to 0.0.
SARConstrPlugin	{Off \| Min <Value1> [\|] Max <Value2>} "<PluginFile>" [IncludeIntervals\|ExcludeIntervals] where <Value1> and <Value2> are unitless.

SAR with Jamming Constraints:

{ConstraintName}	<Parameters>
SarSNRJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SarCNRJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SarSCRJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SarJOverS	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.

SAR Orthogonal Polarization Constraints:

{ConstraintName}	<Parameters>
SarOrthoPolSNR	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SarOrthoPolCNR	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SarOrthoPolSCR	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SarOrthoPolPTCR	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.

SAR Orthogonal Polarization Constraints with Jamming:

{ConstraintName}	<Parameters>
SarOrthoPolSNRJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SarOrthoPolCNRJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SarOrthoPolSCRJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SarOrthoPolJOverS	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.

Search/Track Constraints

Note: The Search/Track constraints will not be applied unless the Search/Track mode is enabled, see the Radar command to set the Model.Mode attribute to "Search_Track".

Note: Search/Track Constraints are also available for Vehicles, as well as Facility, Place and Target objects.

{ConstraintName}	<Parameters>
SrchTrkSinglePulseSNR	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SrchTrkIntegratedSNR	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SrchTrkSinglePulsePDET	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are between 0.0 and 1.0.
SrchTrkIntegratedPDet	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are between 0.0 and 1.0.
SrchTrkIntegratedPulses	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> is an integer greater than 0.
SrchTrkIntegrationTime	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in seconds, greater or equal to 0.0.
SrchTrkDwellTime	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in seconds, greater or equal to 0.0.
SrchTrkMLCFilter	{On \| Off}
SrchTrkSLCFilter	{On \| Off} Note: This option will set the Doppler Altitude Line Filter constraint.
SrchTrkClearDoppler	{On \| Off}
SrchTrkUnAmbigRange	{On \| Off}
SrchTrkUnAmbigDoppler	{On \| Off} Note: This option will set the Doppler Unambiguous Velocity constraint.
SrchTrkConstrPlugin	{Off \| Min <Value1> [\|] Max <Value2>} "<PluginFile>" [IncludeIntervals\|ExcludeIntervals] where <Value1> and <Value2> are unitless.

Search/Track with Jamming Constraints:

{ConstraintName}	<Parameters>
SrchTrkSinglePulseSNRJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SrchTrkSinglePulseJOverS	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SrchTrkSinglePulsePDetJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are between 0.0 and 1.0.
SrchTrkIntegratedSNRJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SrchTrkIntegratedJOverS	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SrchTrkIntegratedPDetJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are between 0.0 and 1.0.
SrchTrkIntegratedPulsesJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are integers, greater or equal to 1.
SrchTrkIntegrationTimeJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in Time, greater or equal to 0.0.
SrchTrkDwellTimeJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in Time, greater or equal to 0.0.

Search/Track Orthogonal Polarization Constraints:

{ConstraintName}	<Parameters>
SrchTrkOrthoPolSinglePulseSNR	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SrchTrkOrthoPolSinglePulsePDet	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are between 0.0 and 1.0.
SrchTrkOrthoPolIntegratedSNR	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SrchTrkOrthoPolIntegratedPDet	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are between 0.0 and 1.0.
SrchTrkOrthoPolIntegratedPulses	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are integers, greater or equal to 1.
SrchTrkOrthoPolIntegrationTime	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in Time, greater or equal to 0.0.
SrchTrkOrthoPolDwellTime	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in Time, greater or equal to 0.0.

Search/Track Orthogonal Polarization Constraints with Jamming:

{ConstraintName}	<Parameters>
SrchTrkOrthoPolSinglePulseSNRJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SrchTrkOrthoPolSinglePulseJOverS	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SrchTrkOrthoPolSinglePulsePDetJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are between 0.0 and 1.0.
SrchTrkOrthoPolIntegratedSNRJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SrchTrkOrthoPolIntegratedJOverS	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in dB, between -3000.0 and 3000.0.
SrchTrkOrthoPolIntegratedPDetJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are between 0.0 and 1.0.
SrchTrkOrthoPolIntegratedPulsesJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are integers, greater or equal to 1.
SrchTrkOrthoPolIntegrationTimeJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in Time, greater or equal to 0.0.
SrchTrkOrthoPolDwellTimeJamming	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in Time, greater or equal to 0.0.

Bistatic Constraints

{ConstraintName}	<Parameters>
BistaticAngle	{Off \| Min <Value1> [\|] Max <Value2>}
RdrXmtAccess	{On \| Off}

RAE Constraints

{ConstraintName}	<Parameters>
RAETgtSpeed	{Off \| Min <Value1> [\|] Max <Value2>}, where <Value1> and <Value2> are in meters/second.
RAEPDET	{Off \| Min <Value1> [\|] Max <Value2>}

Noise Constraints

{ConstraintName}	Parameters
NoiseTemperature	{Off \| Min <Value1> [\|] Max <Value2>} [{NoiseOptions}] [ExcludeIntervals \| IncludeIntervals] where <Value1> and <Value2> are in Kelvin. The following are valid {NoiseOptions}: UseComponents {On \| Off} UseEarth {On \| Off} UseSun {On \| Off} UseAtmosphere {On \| Off} UseUrbanTerrestrial {On \| Off} UseRain {On \| Off} UseCosmicBackground {On \| Off} UseCloudFog {On \| Off} UseTropoScint {On \| Off} UseExternal {On \| Off}

{ConstraintName}

Parameters

NoiseTemperature

{Off | Min <Value1> [|] Max <Value2>} [{NoiseOptions}] [ExcludeIntervals | IncludeIntervals]

where <Value1> and <Value2> are in Kelvin.

The following are valid {NoiseOptions}:

UseComponents {On | Off}
UseEarth {On | Off}
UseSun {On | Off}
UseAtmosphere {On | Off}
UseUrbanTerrestrial {On | Off}
UseRain {On | Off}
UseCosmicBackground {On | Off}
UseCloudFog {On | Off}
UseTropoScint {On | Off}
UseExternal {On | Off}

Refraction Constraints

The Refraction constraints are not valid in STK 8 and later. This includes SetConstraint {RefractedRange | RefractedElevation | RefractedLineOfSight}.

Note: Use the Refraction command instead.

Basic Constraints

Basic constraints for radar 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 radar 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

Temporal constraints for radar 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 radar 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 radar 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 radars 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 radars 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 radars 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 radars are identical to that of vehicles. Visit Connect help for the SetConstraint (Vehicles) command for help setting plugin constraints.

Example

To set a minimum dwell time of 30 seconds for the TestRadar:

SetConstraint */Facility/Customer/Radar/TestRadar SrchTrkDwellTime Min 30

To set a SAR plugin constraint:

SetConstraint */Aircraft/Aircraft1/Radar/SAR SARConstrPlugin Min -100 "VB_RadarSARNIIRSConstraint.vbs"

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Facilities, Places & Targets

Radar

Vehicles

Version

10.1

STK Programming Interface 11.0.1