Description | Example | Return message | Group

SetConstraint (Chain or Constellation)

Set a constraint for a chain or constellation

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 allows you turn constraints on or off. The following Tables list valid values for {ConstraintName} for Chains and Constellations, as well as the values accepted for each. Only one constraint can be set with each SetConstraint command. All angle input values are entered in degrees.

Chain Constraints

The Angle Between constraint is only valid for chains that contain three object strands. In addition, it applies only to the Angle Between report results and doesn't affect access calculations. It constrains access results reported so that results are limited by minimum or maximum vector values of the angle (which is entered in degrees).

"<Filename>" can be the path to a file on your local drive or the path to a file on an SDF server. See Specifying Paths for "<SDFFilePath>" syntax information.

{ConstraintName}Value
MaxAngleBetween{On | Off | <Value1>}
MinAngleBetween{On | Off | <Value1>}
MinLinkTime{On | Off | <TimeValue>}
FilterIntervalsFile{On | Off | "<Filename>"}

Specify an interval file to be used to constrain the chain access. If On is specified a Filename must already be defined or the command will Nack.

Constellation Constraints

Constellations can be constrained to limit access calculations. The constraints available allow you to specify the criteria to be used when the constellation is combined with other objects in a chain.

{ConstraintName}Value
FromOperator{Type} [<Value>]

{Type} can be Any, All, NoneOf, Exactly or AtLeast. If {Type} is AtLeast or Exactly, specify the <Value> parameter, where <Value> is a whole number greater than or equal to 0. By default, {Type} is set to Any.

Use FromOperator to apply the constraint to the times when the constellation is in the from access position in a chain link.

Use ToOperator to apply the constraint to the times when the constellation is in the to access position in a chain link.

The Operator constraint will be applied to both from and to operators.

The Operator constraint is deprecated in STK 11.4. Use FromOperator or ToOperator instead.

ToOperator
Operator
ToParentRestriction{None | SameParent | DifferentParent}

This is used to constrain constellations of sensors, receivers, transmitters, and radars.

FromParentRestriction{None | SameParent | DifferentParent}

This is used to constrain constellations of sensors, receivers, transmitters, and radars.

Examples

To set the constraint for the LandSat constellation to 2 so that access from the Perth facility in the PerthLandSat chain must be able to access two satellites in the LandSat constellation simultaneously:

SetConstraint */Constellation/LandSat FromOperator Exactly 2

To set the constraint for the RtChain chain to the intervals contained in the specified file:

SetConstraint */Chain/RtChain FilterIntervalsFile "c:\STKUser\AccessChain1.int"

To set the constraint for the SensorConst constellation to restrict its links to sensors on the same parent:

SetConstraint */Constellation/SensorConst ToParentRestriction SameParent

Return message

Group membership

This command belongs to the following group(s):

Chains

Version

11.6