Differences

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

--- visual3d:documentation:pipeline:metric_commands:metric_event_sequence_count [2024/07/17 15:42] – removed sgranger
+++ visual3d:documentation:pipeline:metric_commands:metric_event_sequence_count [2025/09/23 19:43] (current) – [Time_Interval] wikisysop
@@ Line 1: / Line 1: @@
+====== Metric Event Sequence Count ======
+====Overview====
+**Metric Event Sequence Count** Creates a metric containing the number of Event Sequences. When a movement or series of movements (like a jump) is defined by an event sequence this command can be used to count the number of repetitions of that movement. The command can be found within the **Pipeline Workshop** under **Metric**.
+====Pipeline Command====
+<code>
+Metric_Event_Sequence_Count
+! /RESULT_METRIC_FOLDER=The resulting folder of the metric
+/RESULT_METRIC_NAME= The resulting name of the metric
+/TIME_INTERVAL= The number of event sequences which occur within a time interval
+/EVENT_SEQUENCE= The event sequence to search for and count
+/EXCLUDE_EVENTS= Don't count a sequence that contains this event
+! /GENERATE_COUNT_TOTAL_IN_GLOBAL=
+;
+</code>
+====Command Parameters====
+The following table shows the command parameters and descriptions:
+|**RESULT_METRIC_FOLDER**|**The resulting folder of the metric**|
+|**RESULT_METRIC_NAME**|**Information about Parameter**|
+|**TIME_INTERVAL**|**The number of event sequences which occur within a time interval**|
+|**EVENT_SEQUENCE**|**The event sequence to search for and count**|
+|**EXCLUDE_EVENTS**|**Don't count a sequence that contains this event**|
+|**GENERATE_COUNT_TOTAL_IN_GLOBAL**|**Create a global count over the active files**|
+====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.
+{{:EventsSequenceCountDlg.png}}
+The dialog box allows you to assign values to the command parameters outlined above.
+====Example: Time_Interval ====
+**The Time_Interval parameter can be used to count the number of events that occur within a specific interval.**
+=== Command Setup ===
+**If a trial is 20 seconds long, and a 5.0 second interval is specified, the result will be 4 metrics. Each metric will contain the number of event sequences which occur within each 5.0 second window.**
+<code>
+Metric_Event_Sequence_Count
+! /RESULT_METRIC_FOLDER= PROCESSED
+/RESULT_METRIC_NAME= LSWING_COUNT_INT
+/TIME_INTERVAL= 5.0
+/EVENT_SEQUENCE= The event sequence to search for and count
+/EXCLUDE_EVENTS= Don't count a sequence that contains this event
+! /GENERATE_COUNT_TOTAL_IN_GLOBAL= Create a global count over the active files
+;
+</code>
+{{:EventsSequenceCount_Interval.png}}|
+=== Result ===
+|**When using a 5 second interval on a 20 second trial, the result will be four metrics (20/5).**\\ \\ (1) The first metric will contain the number of times the sequence occurs during the first 5 seconds of the trial\\ (2) The second metric will contain the number of times the sequence occurs during the 5 - 10 second interval of the trial\\ (3) The third metric will contain the number of times the sequence occurs during the 10 - 15 second interval of the trial\\ (4) The fourth metric will contain the number of times the sequence occurs during the 15 - 20 second interval of the trial\\ \\ **NOTE:** If the event sequence occurs between two intervals (LTO occurs at 4 sec and LHS occurs at 6 sec), this sequence will be included in Interval 1.  |  {{:EventsSequenceCount_Interval_Result.png}}|