Define and modify Interval components and templates.
TimeTool <ScenarioPath> <ParentObject> {Action} {"Interval" | "IntervalTemplate"} <ComponentName> [{IntervalType} <TypeParams>]
The "TimeTool Interval" command is used to add, modify and delete Interval 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 "IntervalTemplate" keyword must be entered.
The following table provides a description of {Action} values and the applicable parameters:
| {Action} | Parameters | Description |
|---|---|---|
| Create | {IntervalType} [<TypeParams>] | <TypeParams> are optional, except where noted below. If no <TypeParams> are specified, default values are used. |
| Modify | {IntervalType} <TypeParams> | The values <ComponentName> {IntervalType} must define an existing Interval component or template. The {IntervalType} 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 an {IntervalType} can be specified on a command line, except where indicated.
The following table describes each Interval type and it's parameters.
| {IntervalType} | <TypeParams> |
|---|---|
| "Between Time Instants" |
|
| "Fixed Duration" |
<Value> is entered in Connect time units. |
| "Fixed Interval" |
Enter the "<DateTime>" in Connect date units. |
| "Fixed Time Offset" |
<Value> is entered in Connect time units. |
| "Interval From List" |
The Number <Value> parameter is valid only if Selection is NumberForward or NumberBackward. <Value> is an integer greater or equal to 1. |
| "Scaled" |
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" |
<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 is not valid for Scenario or Chain objects. |
For details on the format of a reference component (e.g. "<TimeInstant>", "<Interval>", "<RefSystem>", etc) see Component Specification.
When specifying a reference component or template in the Create or Modify commands the {ComponentType} is implied based on the {IntervalType} being created or modified and the {ComponentType} need not be entered. In the second example below, "Satellite/ScenTestSat SunGlint Point" is entered as "Satellite/ScenTestSat SunGlint", since the command is expecting a Point.
To create and modify a Fixed Interval:
TimeTool * Satellite/ScenTestSat Create "Interval" SatInterval1 "Fixed Interval"
TimeTool * Satellite/ScenTestSat Modify "Interval" SatInterval1 "Fixed Interval" StartTime "1 Oct 2011 04:45:00.00" StopTime "1 Oct 2011 05:25:00.00"
To create and modify a Signaled time interval for Exton:
TimeTool * Place/Exton Create "Interval" ExtonInterval5 "Signaled"
TimeTool * Place/Exton Modify "Interval" ExtonInterval5 "Signaled" SignalTransmissionType Light TimeDelayConvergence 1267.89 SignalPathRefSystem CBInertial SignalSense Receive BaseClockLocation "Satellite/ScenTestSat Body.Origin"
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
10
STK Programming Interface 11.0.1