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.

Use the SetConstraint command to turn constraints on or off for chains and constellations. The following tables list valid values for {ConstraintName} for Chain and Constellation objects, as well as the values accepted for each. You can only set one constraint with each SetConstraint command. Enter all angle input values in degrees.

Chain constraints

The AngleBetween 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 you enter 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 you specify On, you must have a Filename already defined or the command will Nack.

Constellation constraints

Constellations can be constrained to limit access calculations. The constraints available enable you to specify the criteria for STK to use 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 was deprecated as of 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