This is an old revision of the document!
Table of Contents
Event Explicit
Overview
The Event_Explicit command is used to manually define and place a custom event label in Visual3D by specifying the exact time at which the event occurs. Unlike automatically detected events (e.g., heel strike detected via force plata date), this command allows users to explicitly set an event based on external input or predefined criteria such as specifying a frame or time.
This command is useful when importing event markers from external sources, synchronizing motion capture events with force data, or manually inserting key moments in the movement cycle.
Pipeline Command
The command below is as seen in the Visual3D application, with the option to name and specify frame OR time.
Event_Explicit /EVENT_NAME= ! /FRAME= ! /TIME= ;
Command Parameters
The following table shows the command parameters and descriptions:
| Parameter | Description |
| /EVENT_NAME= | Specifies the name of the event being created. |
| ! /FRAME= | Defines the frame at which the event occurs. |
| ! /TIME= | Defines the exact time (in seconds) at which the event occurs. |
Dialog
The command can be edited in a text editor or in a dialog form. To edit in the dialog pop up form either click on the Edit button in the pipeline workshop or double-click on the pipeline command. The dialog is shown below.
Examples
Example: Specify an event based on a metric
Here are two examples of creating explicit events based on metrics for frames and time.
This example will place an event at the frame metric TEST_FRAME
Event_Explicit /Event_Name= TEST /Frame= METRIC::PROCESSED::TEST_FRAME ! /Time= ;
This example will place an event at the time metric TEST_TIME
Event_Explicit /Event_Name= TEST /Frame= /Time=METRIC::PROCESSED::TEST_TIME ;
Example: Create events at the start and end of the trial:
Event_Explicit /Event_Name= START /Frame= 1 /Time= ;
EOF is now recognized as the last frame in the file, and the minus sign can be used.
Event_Explicit /Event_Name= END /Frame= EOF /Time= ;
Example: Create an event 10 frames before the end of the trial:
EOF is now recognized as the last frame in the file, and the minus sign can be used.
Event_Explicit /Event_Name= TEST /Frame= EOF - 10 /Time= ;
Example: Create an event at multiple frames
Introduced in Version 6
Event_Explicit /Event_Name= TEST /Frame= LIST(1,5,10) /Time= ;
This command will create three instances of the EVENT_LABEL TEST at frames 1, 5, and 10
Example: Create an event at one second intervals
! Determine the number of ranges ! For some files this might be 1 too many but it won't matter. Set_Pipeline_Parameter_From_For_Loop /PARAMETER_NAME=COUNT /PARAMETER_INDEX_START=1 /PARAMETER_INDEX_END=METRIC::TIME::TOTAL /PARAMETER_INDEX_STEP=1 ! /PARAMETER_INDEX_TYPE=INTEGER ; ! execute a For_Each loop For_Each /ITERATION_PARAMETER_NAME=INDEX ! /ITERATION_PARAMETER_COUNT_NAME= /ITEMS=::COUNT ; Event_Explicit /EVENT_NAME=TEST ! /FRAME= /TIME=::INDEX ; End_For_Each /ITERATION_PARAMETER_NAME=INDEX ;