Joining Conditions

This attribute defines the list of Joining conditions associated with an MCS Follow segment, and also can be used to define attributes of those Joining conditions.

Note: This attribute defines the complete list of Joining conditions each time that it is executed; any previously defined Joining conditions will be wiped out by a new execution of this command.

Syntax

Astrogator <Satellite Object Path> SetValue <Attribute Path>.JoiningConditions <List of Joining Conditions>

Astrogator <Satellite Object Path> SetValue <Attribute Path>.JoiningConditions.{Joining Condition} <Value> [{Unit}]

Description

You can have one or as many Joining conditions as necessary. Available Joining conditions include:

Joining Condition Description
Access Join upon achieving access to another object in the scenario.
Altitude Join at a specified altitude measured with reference to the selected central body.
Always Tripped Join at each integration step and evaluate the constraints. If the constraints are met, or if there are no constraints set, propagation stops; otherwise, propagation advances to the next step and the constraints are evaluated again.
Apoapsis Join at the point farthest from the origin.
Argument of Latitude Join on a specified Argument of Latitude.
Ascending Node Join when crossing the X-Y plane of the coordinate system in the +Z direction.
Delta V Join on a specified V. Use only in defining Joining conditions for finite maneuvers.
Descending Node Join when crossing the X-Y plane of the coordinate system in the -Z direction.
Duration Join after a specified duration.
Epoch Join on a specified date and time.
Lighting Join on a lighting condition (e.g., entering or exiting Direct Sun or Umbra).
Longitude Join on a specified longitude.
Mean Anomaly Join on a specified mean anomaly.
Periapsis Join on the point closest to the origin.
R Magnitude Join at a specified distance from the origin.
True Anomaly Join on a specified true anomaly.
User Select Join on a user-specified value using a user-selected calculation object.
X-Y Plane Cross Join when crossing the X-Y plane.
Y-Z Plane Cross Join when crossing the Y-Z plane.
Z-X Plane Cross Join when crossing the Z-X plane.

Note: When using a Joining condition name that consists of two or more words in the Astrogator user interface, the spaces in the name must be replaced with underscores in the Connect command, or the entire name must be enclosed in quotes (see the examples below).

Examples

Specifying Joining Conditions - For Follow Segment

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Follow.JoiningConditions Duration

Setting the Value for a given Joining Condition - For Follow Segment

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Follow.JoiningConditions.Duration.TripValue 1 hr

STK Programming Interface 11.0.1