Description | Example | Return Message | Group

TimeTool Interval List

Define and modify Interval List components and templates.

Syntax

TimeTool <ScenarioPath> <ParentObject> {Action} {"Interval List" | "Interval ListTemplate"} <ComponentName> [{IntervalListType} <TypeParams>]

Related Commands

Description

The "TimeTool Interval List" command is used to add, modify and delete Interval List components and templates.

For a component object the <ParentObject> is a truncated object path.

For a template the <ParentObject> is an STK class name, and the "Interval ListTemplate" keyword must be entered.

The following table provides a description of {Action} values and the applicable parameters:

{Action} Parameters Description
Create {IntervalListType} [<TypeParams>] <TypeParams> are optional, except where noted below. If no <TypeParams> are specified, default values are used.
Modify {IntervalListType} <TypeParams> The values <ComponentName> {IntervalListType} must define an existing Interval List component or template. The {IntervalListType} can not be modified. <TypeParams> are required.
Delete N/A Delete the component or template identified by <ComponentName>

Any or all of the <TypeParams> for a {IntervalListType} can be specified on a command line, except where indicated.

The following table describes each Interval List type and it's parameters.

{IntervalListType} <TypeParams>
"File"
  • Filename "<IntervalFile>"
  • Reload

"<IntervalFile>" is an STK interval file. For help on creating the STK interval file, see Create & Import External Files - Interval List in STK Help.

The Reload keyword is valid on a Modify command only.

Note: The Filename "<IntervalFile>" parameter is required on the Create command for the "File" Interval List

"Filtered"
  • OriginalIntervalList "<IntervalList>"
  • Filter {FirstIntervals | LastIntervals | Gaps | Intervals | SatisfactionIntervals | RelativeSatisfactionIntervals}

  • MaxNumber <Value>
  • {AtLeast | AtMost} <Value>
  • AdditionalCondition "<ConditionComponent>"
  • {RelativeAtLeast | RelativeAtMost} <Value>

The MaxNumber option is valid if Filter is FirstIntervals or LastIntervals. <Value> is an integer greater or equal to 1.

The {AtLeast | AtMost} options are valid if Filter is Gaps, Intervals or SatisfactionIntervals. <Value> is entered in Connect Time units.

The Condition option is valid if Filter is SatisfactionIntervals or RelativeSatisfactionIntervals.

The {RelativeAtLeast | RelativeAtMost} options are valid if Filter is RelativeSatisfactionIntervals. <Value> is a percent between 0.0 and 100.0.

"Fixed Interval List"
  • AddInterval "<StartTime>" "<StopTime>"
  • DeleteInterval {"<StartTime>" "<StopTime>" | All}
  • ImportIntervals "<IntervalComponent>"
  • LoadIntervals "<Filename>"

Intervals will be added to the existing list, use DeleteInterval All to replace an interval list.

Add, Load, Import and Delete can be entered on the same command line, Delete will be done first, then Add, Load or Import

All times are entered in Connect time units.

"<IntervalComponent>" can be an Interval or Interval List type component.

"<Filename>" must be in the STK interval list file format and should end with a .int extension.

Note: Duplicate intervals will not be added. The command will nack if overlapping intervals are entered.

"Fixed Time Offset"
  • ReferenceIntervalList "<IntervalList>"
  • TimeOffset <Value>

<Value> is entered in Connect time units.

"Merged"
  • IntervalsA "<IntervalOrIntervalList>"
  • IntervalsB "<IntervalOrIntervalList>"
  • Operation {AND | OR | XOR | MINUS}

The "<IntervalOrIntervalList>" can be an Interval component or an Interval List component and should include the time component type, e.g. "Satellite/Sat1 EphemerisTimeSpan Interval"

"Satisfaction"
  • Condition "<ConditionComponent>"

Advanced options:

  • SaveOption {UseApplicationPrefs | SaveComputedData | None}
  • SetTimeLimits {UseApplicationPrefs | Local}
  • TimeLimits "<IntervalOrIntervalList>"

If SetTimeLimits is set to Local then the time interval or interval list specified by the TimeLimits parameter will be used. The "<IntervalOrIntervalList>" should include the time component type, e.g. "Satellite/Sat1 EphemerisTimeSpan Interval"

  • SamplingType {FixedStep | RelativeTolerance | CurvatureTolerance}

Parameters for SamplingType FixedStep:

  • TimeStep <TimeStep>

Parameters for SamplingType RelativeTolerance:

  • MinimumTimeStep <MinStep>
  • MaximumTimeStep <MaxStep>
  • StepAtBoundaries <StepBound>
  • SamplingRelativeTolerance <RelTol>
  • SamplingAbsoluteTolerance <AbsTol>

Parameters for SamplingType CurvatureTolerance:

  • MinimumTimeStep <MinStep>
  • MaximumTimeStep <MaxStep>
  • StepAtBoundaries <StepBound>
  • SamplingRelativeTolerance <RelTol>
  • SamplingAbsoluteTolerance <AbsTol>
  • CurvatureTolerance <CurveTol>

<TimeStep>, <StepBound>, <MinStep> and <MaxStep> are entered in Connect time units and must be between 1e-13 and 99999999999.0.

<RelTol>, and <CurveTol> must be between 1e-13 and 1.0

<AbsTol> must be greater or equal to 1e-13

Parameters for Convergence:

  • ConvergeSense {Simple | FromAbove | FromBelow}
  • ConvergeAbsoluteTolerance <ConvergeAbsTol>
  • ConvergeRelativeTolerance <ConvergeRelTol>
  • TimeTolerance <TimeTol>

<TimeTol> is entered in Connect time units, and must be between 1e-13 and 99999999999.0.

<ConvergeAbsTol> must be greater or equal to 1e-13

<ConvergeRelTol> must be between 1e-13 and 1.0

Note: The Satisfaction Interval List is not valid for Scenario or Chain objects.

"Scaled"
  • OriginalIntervalList "<IntervalList>"
  • AbsoluteIncrement <Value>
  • RelativeIncrement <Value>

AbsoluteIncrement <Value> is entered in Connect time units. RelativeIncrement <Value> is a real number greater or equal to -100.0. AbsoluteIncrement and RelativeIncrement can not both be entered in the same command.

"Signaled"
  • Original "<IntervalList>"
  • BaseClockLocation "<Point>"
  • TargetClockLocation "<Point>"
  • SignalSense {Transmit | Receive}
  • SignalTransmissionType {Light | Custom}
  • SpeedValue <Speed>
  • TimeDelayConvergence <Delay>
  • SignalPathRefSystem {UseAccessDefault | SSBarycenter | CBInertial | Custom}
  • CustomSystem "<RefSystem>"

<Speed> is entered in Connect Time units / seconds.

The SpeedValue parameter is valid if SignalTransmissionType is Custom.

<Delay> is entered in Connect time units.

The CustomSystem parameter is valid if SignalPathRefSystem is Custom.

Note: The Signaled Interval List is not valid for Scenario or Chain objects.

For details on the format of a reference component (e.g. "<IntervalList>", "<ConditionComponent>", etc) see Component Specification.

Example

To create and modify a Scaled Interval List:

TimeTool * Satellite/ScenTestSat Create "Interval List" SatList8 "Scaled"

TimeTool * Satellite/ScenTestSat Modify "Interval List" SatList8 "Scaled" OriginalIntervalList "Satellite/ScenTestSat SatList2 Interval List" AbsoluteIncrement 28.5

To create and modify a Satisfaction Interval List:

TimeTool * Satellite/ScenTestSat Create "Interval List" SatList2 "Satisfaction" Condition "Satellite/ScenTestSat BeforeStop Condition"

TimeTool * Satellite/ScenTestSat Modify "Interval List" SatList2 "Satisfaction" SaveOption UseApplicationPrefs SetTimeLimits UseApplicationPrefs

TimeTool * Satellite/ScenTestSat Modify "Interval List" SatList2 "Satisfaction" MinimumTimeStep 45.0 SamplingType RelativeTolerance MaximumTimeStep 1845.67 StepAtBoundaries 45.0

To create and add two intervals to a Fixed Interval List:

TimeTool * Satellite/ScenTestSat Create "Interval List" SatInt32 "Fixed Interval List"

TimeTool * Satellite/ScenTestSat Modify "Interval List" SatInt32 "Fixed Interval List" AddInterval "28 Feb 2011 17:10:00.000" "28 Feb 2011 17:30:00.000" AddInterval "28 Feb 2011 17:50:00.000" "28 Feb 2011 18:10:00.000"

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Area Targets

Chains

Comm

Facilities, Places & Targets

Line Targets

Radar

Scenarios

Sensors

Stars & Planets

Object Tools

Vehicles

Volumetric

VO

VO Objects

Version

10.0.1

STK Programming Interface 11.0.1