Chains_RM Access
Calculate various access data within and outside of a chain
Syntax
Chains_RM <ApplicationPath> Access {AccessType}
Description
The Chains_RM Access command returns various types of access data, including all access data, for a specified interval, for different strands, or between two specified objects. The command is executed at the application level for all {AccessType} options and acts on all chains in the scenario.
When chain accesses are computed in parallel, object to object access objects are not created in the local STK instance. As a result, the output for some {AccessTypes} may not have the same results compared to the results when chains accesses are not computed in parallel.
{AccessType} can be:
| {AccessType} | Description |
|---|---|
| All | Causes STK to calculate the complete chain access intervals for all chains defined in the current scenario. Return data includes all chain intervals that form a complete access for the chain and all other two-object access intervals that have already been calculated (either via the user interface or using one of the Access commands), including those calculated to determine complete chain accesses. Duplicate combinations (e.g., Shuttle to WhiteSands and WhiteSands to Shuttle) are included in the return message. |
| Intervals | Returns a message that contains complete chain access intervals for all chains currently defined in the scenario. This means that access for each valid strand in a chain are calculated. |
| Strands | Returns a message that contains all chain strand intervals for all chains currently defined in the scenario. A strand represents one possible access pathway through a chain. For a chain defined by a series of individual objects, only a single strand is possible. In the case where one or more objects in the chain are constellations, multiple strands are possible. Further, any constellation constraints determine the number of possible strands for a chain that includes constellation objects. |
| TwoObject | Causes STK to calculate the complete chain access intervals for all chains in the current scenario. Return data includes all two-object access intervals calculated for the chain as well as all two-object access intervals already calculated in the scenario. For scenarios that contain more than one chain, intervals for all chains are included. |
| EndObjectStrands <EndObjectPath> | Returns a message that contains all extended chain strand intervals for all chains currently defined in the scenario if the command is executed on the application path, or for a single chain if the command is executed on a chain object path. Extended strands are the normal chain strands which have been lengthened to include the additional STK object specified as a parameter <EndObjectPath>. |
Examples
To calculate and view accesses for all chains in the current scenario:
Chains_RM / Access All
Return message
Sample return message for the Chains_RM command using the TwoObject {AccessType}ACK CHAIN_RM 3 73 CHAINS_RM 111 /Application/STK/Scenario/Scenario1/Facility/Perth /Application/STK/Scenario/Scenario1/Facility/Baikonur NoAccesses CHAINS_RM 114 /Application/STK/Scenario/Scenario1/Facility/Santiago /Application/STK/Scenario/Scenario1/Facility/Baikonur NoAccesses . . . CHAINS_RM 250 /Application/STK/Scenario/Scenario1/Satellite/ERS1 /Application/STK/Scenario/Scenario1/Facility/WhiteSands 3 1 Nov 2000 00:35:03.50 1 Nov 2000 00:47:20.85 1 Nov 2000 02:13:31.55 1 Nov 2000 02:28:22.00 1 Nov 2000 03:55:11.46 1 Nov 2000 04:00:00.00
Group membership
This command belongs to the following group(s):
Version
4.1.1