HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » pipeline » event_commands » Event Define Event Sequence
visual3d:documentation:pipeline:event_commands:event_define_event_sequence

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
visual3d:documentation:pipeline:event_commands:event_define_event_sequence [2025/02/18 19:31] – wikisysopvisual3d:documentation:pipeline:event_commands:event_define_event_sequence [2025/03/03 19:26] (current) – [Pipeline Command] wikisysop
Line 2: Line 2:
  
 ==== Overview ==== ==== Overview ====
-Defining an [[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Event_Sequence|Event_Sequence]] as a single command parameter. The parameter Event_Sequence is used in many of the Events and Metrics commands. This is an extension to defining a __Start Event__ and __Stop Event__ that indicate which frames should be processed (i.e. LHS (left heel strike) to LHS). +This command in Visual3D's pipeline allows users to __define a sequence of events based on an ordered list of existing events__, useful for identifying movement phases within a dataset. Essentially defining an [[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Event_Sequence|Event_Sequence]] as a single command parameter, acting as an extension to defining a Start and Stop Event that indicate which frames should be processed. 
  
-This option provides the flexibility to set offsets on the Event_Sequence and to embed an Event Sequence inside another event. The following image shows the Define Event Sequence dialog box in the application, rather than doing this manually, we can achieve the same functionality using the command pipeline. 
  
  
 ==== Pipeline Command ==== ==== Pipeline Command ====
-The following shows the command to achieve the action of defining a start and stop event for which frames should be processed. 
  
 <code> <code>
 Event_Define_Event_Sequence Event_Define_Event_Sequence
-/EVENT_SEQUENCE_NAME=RSTANCE +/EVENT_SEQUENCE_NAME= 
-/EVENT_SEQUENCE=RON+ROFF+! /EVENT_SEQUENCE=
 ! /EXCLUDE_EVENTS= ! /EXCLUDE_EVENTS=
 ! /INSIDE_OF_SEQUENCE= ! /INSIDE_OF_SEQUENCE=
-/OFFSET_FROM_START=-1+! /OFFSET_FROM_START=
 ! /OFFSET_FROM_END= ! /OFFSET_FROM_END=
-/OFFSET_BY=FRAMES +! /OFFSET_BY=PERCENT 
-/EVENT_SEQUENCE_INSTANCE=0+! /EVENT_SEQUENCE_INSTANCE=
 ; ;
 +
 </code> </code>
  
 ==== Command Parameters ==== ==== Command Parameters ====
 +The following table shows the command parameters and descriptions:
  
-In this case, the event sequence will start one frame before the sequence RON+ROFF. The resulting signal can be used wherever an Event_Sequence is used. +|**Parameter**|**Description**| 
- +|**/EVENT_SEQUENCE_NAME=**|Specifies the name of the event sequence being defined.| 
-For example, the use case in the Metric_Mean command. Instead of the following syntax:+|**/EVENT_SEQUENCE=**|Defines the ordered list of existing events that form the sequence.| 
 +|**/EXCLUDE_EVENTS=**|Lists events to be excluded from the sequence, preventing them from being part of the defined sequence.| 
 +|**/INSIDE_OF_SEQUENCE=**|Restricts the event sequence to only include events that occur inside a specified sequence.| 
 +|**/OFFSET_FROM_START=**|Applies a time or frame offset from the start of the sequence.| 
 +|**/OFFSET_FROM_END=**|Applies a time or frame from the end of the sequence.| 
 +|**/OFFSET_BY=PERCENT**|Offsets the event within the sequence by a specified percentage of the sequence duration.| 
 +|**/EVENT_SEQUENCE_INSTANCE=**|Specifies which instance of the event sequence to use when multiple sequences exist.|
  
 ==== Dialog ==== ==== Dialog ====
-{{:DefineEventSequence.jpg}}+After adding the **Event_Define_Event_Sequence** command into the pipeline on the Visual3D application, the user can double-click with the left mouse button in order to open the following dialog:
  
 +{{:DefineEventSequence.jpg?400}}
 +
 +  * **Defined Events** and **Event Sequence**, lists of available events in the dataset, and list of selected events that define the sequence, respectively.
 +  * **Event Sequence Instance**: Defines which instance of the event sequence should be used.
 +  * **Range Start and End Offsets**: Allows adjustments to where the sequence starts and ends.
 +  * **Define Sequence Inside of Outer Sequence**: Allows for nested event sequences, meaning the defined sequence occurs within a broader sequence.
 ==== Examples ==== ==== Examples ====
 +The following examples will go through the use of the **Event_Define_Event_Sequence** command in the Visual3D application.
 +
 +=== Example 1 ===
 +A common example of an event sequence is the gait cycle, representing the repetitive sequence of events that occur from one heel strike of a foot to the next heel strike of the same foot.
 +
 +The **Event_Define_Event_Sequence** command can be used to name this event sequence "Full Gait Cycle" and include the events detected using the [[visual3d:documentation:pipeline:event_commands:automatic_gait_events|Automatic_Gait_Events]] command. The full gait cycle is considered LHS-LHS, the instance will be set to 0 to consider all instances of the event sequence.
 +
 +<code>
 +Automatic_Gait_Events
 +! /FRAME_WINDOW=8
 +! /USE_TPR=TRUE
 +! /TPR_EVENT_INSTANCE=1
 +;
 +
 +Event_Define_Event_Sequence
 +/EVENT_SEQUENCE_NAME=Full Gait Cycle
 +/EVENT_SEQUENCE=LHS+LON+LOFF+LTO+RHS+RON+ROFF+RTO+LHS
 +! /EXCLUDE_EVENTS=
 +! /INSIDE_OF_SEQUENCE=
 +! /OFFSET_FROM_START=
 +! /OFFSET_FROM_END=
 +! /OFFSET_BY=PERCENT
 +/EVENT_SEQUENCE_INSTANCE=0
 +;
 +</code>
 +
 +Once this pipeline is executed, you should notice a new folder labelled **SEQUENCE** within the Event_Label folder in the data tree as seen below:
 +
 +{{:visual3d:documentation:pipeline:event_commands:event_sequence_data_tree.png?300|}}
 +
 +=== Example 2 ===
 +
 +As an extension to the previous example, we can add the **Event_Define_Event_Sequence** command twice again to the pipeline in order to define the Swing and Stance phases, both embedded inside of the Full Gait Cycle event sequence.
 +
 +<code>
 +Event_Define_Event_Sequence
 +/EVENT_SEQUENCE_NAME=Stance Phase
 +/EVENT_SEQUENCE=LHS+LON+LOFF+LTO
 +! /EXCLUDE_EVENTS=
 +/INSIDE_OF_SEQUENCE=Full Gait Cycle
 +! /OFFSET_FROM_START=
 +! /OFFSET_FROM_END=
 +! /OFFSET_BY=PERCENT
 +/EVENT_SEQUENCE_INSTANCE=0
 +;
 +
 +Event_Define_Event_Sequence
 +/EVENT_SEQUENCE_NAME=Swing Phase
 +/EVENT_SEQUENCE=LTO+RHS+RON+ROFF+RTO+LHS
 +! /EXCLUDE_EVENTS=
 +/INSIDE_OF_SEQUENCE=Full Gait Cycle
 +! /OFFSET_FROM_START=
 +! /OFFSET_FROM_END=
 +! /OFFSET_BY=PERCENT
 +/EVENT_SEQUENCE_INSTANCE=0
 +;
 +</code>
 +
 +==== Notes ====
 +
 +=== Equivalent Pipeline Commands ===
 +The following will show a different method to create an event sequence.
 +
 +In this case, the event sequence will start one frame before the sequence RON+ROFF. The resulting signal can be used wherever an Event_Sequence is used.
 +
 +For example, the use case in the Metric_Mean command. Instead of the following syntax:
  
 <code> <code>
Line 57: Line 136:
  
  
-==== Visual3D Versions supporting Subject Prefixes ====+=== Visual3D Versions supporting Subject Prefixes ===
  
 **NOTE**: When using events in a command, the commands will iterate across subjects contained in the current workspace. As such, events being created should list the generic event label name, and as the event command iterates through subjects, it will create the subject specific events that are prefixed with the specific subject prefix. **NOTE**: When using events in a command, the commands will iterate across subjects contained in the current workspace. As such, events being created should list the generic event label name, and as the event command iterates through subjects, it will create the subject specific events that are prefixed with the specific subject prefix.
visual3d/documentation/pipeline/event_commands/event_define_event_sequence.1739907106.txt.gz · Last modified: 2025/02/18 19:31 by wikisysop