Adds an articulation to the given model.
VO <ObjectPath> AddArticulation {ArticulateOptions}
The VO AddArticulation command allow you to define the movement for movable parts on the selected model. The articulations perform dynamic transformations on the primitives in a model.
The VO AddArticulation command can be issued at any time provided the scenario and model of interest have been loaded. The actual articulation occurs only at the specified StartTime and Duration.
The following table describes the {ArticulateOptions} used to create an articulation to be added to a vehicle, facility, place or target model. The ArticulationName, TransformationName and Duration are required values, the command will Nack if either of these is missing or incorrect. All other values default to 0.0.
| {ArticulateOptions} | Description |
|---|---|
| ArticulationName <Value> | The <Value> is a character string representing the name of the model articulation to attach this articulation to. The maximum length of the articulation name is 31. |
| TransformationName <Value> | The <Value> is a character string representing the name of the transformation that is to be updated. The maximum length of the transformation name is 31. |
| StartTime <Value> | The <Value> is a floating-point number representing epoch seconds for the starting time of the articulation. |
| StartTimeConUnit {TimeValue} | The {TimeValue} is the starting time of the articulation. For valid {TimeValue} values see Time Options. |
| Duration <Value> | The <Value> is a floating-point number representing the number of seconds that the articulation is to run. This value must be greater than 0.0. |
| DeadBandDuration <Value> | The <Value> is a floating-point number representing the number of seconds from the end time that the end value is reached. This value must be greater or equal to 0.0 and less than or equal to Period. |
| AccelDuration <Value> | The <Value> is a floating-point number representing the factor to non-linear acceleration of the articulation. This value must be greater or equal to 0.0. |
| DecelDuration <Value> | The <Value> is a floating-point number representing the factor to non-linear deceleration of the articulation. This value must be greater or equal to 0.0. |
| DutyCycleDelta <Value> | The <Value> is a floating-point number representing the percent offset from the start time to the end time that articulation cycle will begin. This value must be greater or equal to 0.0 and less than or equal to Duration. |
| Period <Value> | The <Value> is a floating-point number representing the number of seconds to complete an entire cycle. This value must be greater or equal to 0.0 and less than or equal to Duration. |
| StartValue <Value> | The <Value> is a floating-point number representing the starting value of the articulation. The value must be greater than the minimum articulation value and less than the maximum articulation value. |
| AutoStartValue | Use in place of the StartValue option
and the articulation will start from whatever the articulation
value happens to be when the articulation "StartTime" is reached.
Note: If the "Period" option is used, the "StartValue" option is still required to determine the full range of motion for the period. |
| EndValue <Value> | The <Value> is a floating-point number representing the ending value of the articulation. The value must be greater than the minimum articulation value and less than the maximum articulation value. |
| Force | Force the new articulation to be applied, overriding overlapping articulations. Any articulation that is currently in-progress when the new articulation starts will be cut short. Any other overlapping articulations will be removed. |
Note: If the DUTYCYCLEDELTA is greater than 0.0, ACCELDURATION and DECELDURATION should be set to 0.0 and vice versa.
Add the following two articulations to Satellite1:
VO */Satellite/Satellite1 AddArticulation ArticulationName SlrPnl-1 TransformationName xrot StartTime 0 Duration 300 DeadBandDuration 0.0 AccelDuration 0 DecelDuration 0 DutyCycleDelta 0 Period 10 StartValue 10 EndValue 60
VO */Satellite/Satellite1 AddArticulation ArticulationName SlrPnl-1 TransformationName xrot StartTime 330 Duration 20 DeadBandDuration 11 StartValue 60 EndValue -30
Add an articulation to Satellite1, specifying the StartTime in Connect date units (the default date unit is UTCG):
VO */Satellite/Satellite1 AddArticulation ArticulationName SRB_Left TransformationName MoveX StartTimeConUnit "08 Jun 2007 23:40:08.018" Duration 250 StartValue 0 EndValue -1000
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
10
STK Programming Interface 11.0.1