Collection

Create and set the features of a Satellite Collection object.

Syntax

Collection <objPath> {Define|Interval|Metadata|Promote|Reference|Subset} <Parameters>

Description

The Collection Connect command enables you to create a Satellite Collection object and set its features. The command has six unique action options (Define|Interval|Metadata|Promote|Reference|Subset) associated with it. For a description of the Define action option for creating a satellite collection, see Collection Define. This topic page provides descriptions and examples of the other five action options that set the features of an existing satellite collection.

Interval

The Interval action option has the following format:

Interval <value1> [<value2>]

It sets the analysis interval for the satellite collection. You can use <value1> as a start time (in Connect units), a Time Instant time component, or a Time Interval time component. If <value1> is not a Time Interval Component, then <value2> is the stop time (in Connect units), a Time Instant time component, or a duration represented as a time increment.

Metadata

The Metadata action option has the following format:

Metadata {[Specify <"filename"> | CreateEmptyFile <"filename"> | Remove | Reload]}

The following table describes the Metadata optional parameters:

Promote

The Promote action option has the following format:

Promote {[Entry <name> | PromotedName <name> | Subset <name> | All]}

The following table describes the Promote optional parameters:

If you provide more than one action (Entry, Subset, All), STK will only act on the last action, unless the last action is All and Subset <name> appears earlier. In that case, STK will act on Subset.

Reference

The Reference action option has the following format:

Reference {[Specify {Default | Subset <"subsetName">} ReferenceObject <"objectPath"> | Remove {Default | Subset <"subsetName">} ]}

The following table describes the Reference optional parameters:

Subset

The Subset action option has the following format:

Subset {[ AutoGeneration {Yes|On|True|No|Off|False} | Remove <"subsetName"> | Modify <"subsetName"> (params) | Specify <"subsetName"> (params)]}

The following table describes the Subset optional parameters:

QueryExpression

A query expression is a boolean expression comprised of metadata criteria and the standard boolean operators (AND, OR, NOT).

The metadata criteria require the values of metadata, and supplemental metadata if you provide any, to meet certain specified objectives.

A criterion's objectives depend on the value type of a particular metadata item. Here is a list of possibilities:

Criteria may appear as arguments to boolean operators, as shown in the following table:

Expressions may also contain nested operators, for example AND(crit1, NOT(crit2), OR(crit3, crit4)), OR(AND(crit1, crit2), AND(crit3, NOT(crit4)), etc.

However, the Satellite Collection Subset user interface is restricted in its ability to display complicated boolean expressions. Here are examples of things you can and cannot do:

• You can use enumerations allowing multiple values using an OR operator. For example, "Name IN val1|val2" is displayed as "OR(Name is val1, Name is val2)".
• You can use negated enumerations using an AND operator. For example, "NOT(Name IN val1|val2)" is displayed as "AND(Name is not val1),Name is not val2)".
• STK supports Min/Max queries in the user interface using an AND operator. For example, "Name Min minVal Max maxVal" is displayed as "AND(Name >= minVal, Name <= maxVal)".
• You can use negated Min/Max queries using an OR operator. For example, "NOT(Name Min minVal Max maxVal)" is displayed as "OR(Name <= minVal),Name >= maxVal))".
• NOT can only be a criterion argument, not an operator expression. For example, you cannot use NOT(AND(crit1, crit2)), but you can use its equivalent OR(NOT(crit1), NOT(crit2)).

  Caution: The Subset user interface doesn't strictly implement NOT. For example, while the criterion "Name Min 4" is displayed as "Name >= 4", "NOT(Name Min 4)" is displayed as "Name <= 4", which is not the equivalent for an entry with a value of exactly 4.

• AND supports any number of criteria as arguments and one OR argument that itself does not contains only criteria and not any OR and AND subexpressions.
• AND supports only two arguments when each is an AND or OR expression. Examples are AND(OR(criteria), OR(criteria)), AND(AND(criteria), OR(criteria)), and AND(AND(criteria), AND(criteria)).
• OR supports any number of criteria as arguments and one OR argument that itself does not contains only criteria and not any OR and AND subexpressions.
• OR supports only two arguments when each is an AND or OR expression. Examples are OR(AND(criteria), AND(criteria)), OR(OR(criteria), AND(criteria)), and OR(OR(criteria), OR(criteria)).

Examples

Analysis interval sets the interval over which the Satellite Collection is valid

Supplemental Metadata

Reference object association

Subset Creation and Removal; examples assume Walker was used to create entries with "Plane" metadata

Object Promotion

Query Expressions

Return message

Group membership

This command belongs to the following group(s):

SatelliteCollection

Version

12.8