====== 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}}|