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

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 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).

{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. The format is:

SetConstraint <ConObjectPath> Operator {Type} <Value>

Operator is the only valid {ConstraintName} for a constellation.

{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.

Example

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 Operator 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"

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Chains

Version

8.0

STK Programming Interface 11.0.1