This is an old revision of the document!
Table of Contents
Event Between
Overview
The Event_Between pipeline command creates a new event label based on the time interval between two existing events in the C3D File (i.e. between the first and last events). This command is useful when analyzing motion data that requires identifying specific time points between known events.
This function allows users to:
- Define a new event occurring between two existing events.
- Specify whether the new event should be placed at the Start, End, or Midpoint of the interval.
Pipeline Command
Event_Between /NEW_EVENT_NAME= ! /RANGE_INSTANCE=0 ! /EVENT_SEQUENCE= ! /EXCLUDE_EVENTS= ! /FRAME_OFFSET=0 ! /TIME_OFFSET= ! /PERCENT_OFFSET=
Command Parameters
The following table shows the command parameters:
| Event_Between | Description |
| /NEW_EVENT_NAME= | Specifies the name of the new event to be created. |
| ! /RANGE_INSTANCE= 0 | The number of instances to label. |
| ! /EVENT_SEQUENCE= | Defines the event sequence that the new event should be created between. |
| ! /EXCLUDE_EVENT= | Skips an event sequence if it contains one of the events listed in this parameter. (ex. BAD event) |
| ! /FRAME_OFFSET= 0 | Specifies frame offset from first event of sequence. |
| ! /TIME_OFFSET= | Specifies time offset from first event of sequence. |
| ! /PERCENT_OFFSET= | Specifies percent offset from first even of sequence. |
Offsets (FRAME_OFFSET, TIME_OFFSET, and PERCENT_OFFSET) allow fine control over the event placement, only one may be active and specified when the command is executed. By default, value is 0.
Dialog
After adding the Event_Between command into the pipeline on the Visual3D application, the user can double-click with the Left Mouse Button in order to to open the following dialog:
Event_Between Examples
A dynamic trial has two pre-existing events, LHS (Left Heel Strike) and LTO (Left Toe Off).
EXAMPLE 1 - Range_Instance = 0
- RANGE_INSTANCE = 0 → all instances of the Event_Sequence will be used
- FRAME_OFFSET = 10 → the new event will be created 10 frames after the first event
Event_Between /NEW_EVENT_NAME=BTWN !/RANGE_INSTANCE=0 /EVENT_SEQUENCE=LHS+LTO !/EXCLUDE_EVENT= /FRAME_OFFSET=10 !/TIME_OFFSET= !/PERCENT_OFFSET= ;
EXAMPLE 2 - Range_Instance = 2
- RANGE_INSTANCE = 2 → the 2nd instance of the Range will be used
Event_Between /NEW_EVENT_NAME= BTWN !/RANGE_INSTANCE=2 /EVENT_SEQUENCE=LHS+LTO !/EXCLUDE_EVENT= /FRAME_OFFSET=10 !/TIME_OFFSET= !/PERCENT_OFFSET= ;
EXAMPLE 3 - Range_Instance = -1
- RANGE_INSTANCE = -1 → the last instance of the Range will be used
Event_Between /NEW_EVENT_NAME= BTWN !/RANGE_INSTANCE=2 /EVENT_SEQUENCE=LHS+LTO !/EXCLUDE_EVENT= /FRAME_OFFSET=10 !/TIME_OFFSET= !/PERCENT_OFFSET= ;
Note: this is exactly the same result as the example above because for this example signal the last instance = the second instance.