Table of Contents
Metric Event Count
Creates a metric containing the number of events that occur in an event sequence or time interval.
Metric_Event_Count /RESULT_METRIC_NAME= /RESULT_METRIC_FOLDER=PROCESSED /EVENT_NAME= /TIME_INTERVAL= /EVENT_SEQUENCE= /EXCLUDE_EVENTS= /GENERATE_COUNT_TOTAL_IN_GLOBAL=TRUE ;
Prior to Version 5.00.29
the user could select “either” an Event_Sequence/Exclude Sequence or a Time_Interval if Event_Sequence/Exclude Sequence The count of the specified Event includes all sequences in the file if Time_Interval (specified as a number) A count of events within each time interval (starting from Time=0) is specified as a separate frame. For example, if there were three ranges defined by the time sequence, there would be 3 frames of data in the resulting metric.
Starting in Version 5.00.29
the user can select both an Event_Sequence/Exclude Sequence and a Time_Interval but only the first Event_Sequence is used.
If the Time_Interval is empty the command behaves as before.
If the Time_Interval is populated (a number or expression) the start time is the first event in the event_sequence.
As of Visual3Dv5.00.29 this command must be edited manually.
User Dialog Starting in Version 5.01.14
| In Visual3D v5.01.14 the user dialog was introduced. The command works the same as described in v5.00.29, however the user may now modify the command using the GUI interface. |  |
Example_1
Select_Active_File
/FILE_NAME= ALL_FILES
! /QUERY=
;
Metric_Event_Count
/RESULT_METRIC_FOLDER=PROCESSED
/RESULT_METRIC_NAME=LON_COUNT
/EVENT_NAME=LON
/TIME_INTERVAL=
/EVENT_SEQUENCE=
/EXCLUDE_EVENTS=
/GENERATE_COUNT_TOTAL_IN_GLOBAL= TRUE
;
Result
LON_COUNT will count all events in the file and a metric value LON_COUNT will be created in the METRIC::PROCESSED folder.
“Since GENERATE_COUNT_TOTAL_IN_GLOBAL is set to TRUE, the total number of LON events in the workspace will be created.
To see this value set the Active File to GLOBAL and a metric value LON_COUNT will be created in the METRIC::PROCESSED folder.
Example_2
This example shows 3 ways the Metric_Event_Count command can be used.
Consider a set of 5 files containing the following event LHS.
Event LHS mvc004.c3d 0.960000 2.240000 3.500000 mvc003.c3d 0.980000 2.260000 3.560000 mvc002.c3d 1.000000 2.260000 3.600000 mvc005.c3d 0.920000 2.140000 3.360000
Count events across entire file
Count across the entire file Metric_Event_Count /RESULT_METRIC_NAME=LHS_COUNT /RESULT_METRIC_FOLDER=PROCESSED /EVENT_NAME=LHS /TIME_INTERVAL= /EVENT_SEQUENCE= /EXCLUDE_EVENTS= /GENERATE_COUNT_TOTAL_IN_GLOBAL=TRUE ; Result mvc005.c3d Event_Count= 3 mvc002.c3d Event_Count= 3 mvc003.c3d Event_Count= 3 mvc004.c3d Event_Count= 3 Global_Event_Count= 12
Count events across entire file in time intervals
Count across the entire file at 1 second intervals Metric_Event_Count /RESULT_METRIC_NAME=LHS_COUNT /RESULT_METRIC_FOLDER=PROCESSED /EVENT_NAME=LHS /TIME_INTERVAL=1 /EVENT_SEQUENCE= /EXCLUDE_EVENTS= /GENERATE_COUNT_TOTAL_IN_GLOBAL=TRUE ; Result mvc005.c3d Interval= 0.000000 to 1.000000 Event_Count= 1 Interval= 1.000000 to 2.000000 Event_Count= 0 Interval= 2.000000 to 3.000000 Event_Count= 1 Interval= 3.000000 to 4.000000 Event_Count= 1 Interval= 4.000000 to 4.200000 Event_Count= 0 mvc002.c3d Interval= 0.000000 to 1.000000 Event_Count= 0 Interval= 1.000000 to 2.000000 Event_Count= 1 Interval= 2.000000 to 3.000000 Event_Count= 1 Interval= 3.000000 to 4.000000 Event_Count= 1 Interval= 4.000000 to 4.580000 Event_Count= 0 mvc003.c3d Interval= 0.000000 to 1.000000 Event_Count= 1 Interval= 1.000000 to 2.000000 Event_Count= 0 Interval= 2.000000 to 3.000000 Event_Count= 1 Interval= 3.000000 to 4.000000 Event_Count= 1 Interval= 4.000000 to 4.600000 Event_Count= 0 mvc004.c3d Interval= 0.000000 to 1.000000 Event_Count= 1 Interval= 1.000000 to 2.000000 Event_Count= 0 Interval= 2.000000 to 3.000000 Event_Count= 1 Interval= 3.000000 to 4.000000 Event_Count= 1 Interval= 4.000000 to 4.380000 Event_Count= 0 Global_Event_Counts Global_Event_Count= 3 Global_Event_Count= 1 Global_Event_Count= 4 Global_Event_Count= 4 Global_Event_Count= 0
Count events in a set number of intervals across entire file
Count over 5 intervals from the event_sequence START+END Where START=1.0 and END=4.0 for all files Metric_Event_Count /RESULT_METRIC_NAME=LHS_COUNT /RESULT_METRIC_FOLDER=PROCESSED /EVENT_NAME=LHS /TIME_INTERVAL=(EVENT_LABEL::ORIGINAL::END-EVENT_LABEL::ORIGINAL::START)/5 /EVENT_SEQUENCE=START+END /EXCLUDE_EVENTS= /GENERATE_COUNT_TOTAL_IN_GLOBAL=TRUE ; Result mvc005.c3d Interval= 1.000000 to 1.600000 Event_Count= 0 Interval= 1.600000 to 2.200000 Event_Count= 1 Interval= 2.200000 to 2.800000 Event_Count= 0 Interval= 2.800000 to 3.400000 Event_Count= 1 Interval= 3.400000 to 4.000000 Event_Count= 0 mvc002.c3d Interval= 1.000000 to 1.600000 Event_Count= 1 Interval= 1.600000 to 2.200000 Event_Count= 0 Interval= 2.200000 to 2.800000 Event_Count= 1 Interval= 2.800000 to 3.400000 Event_Count= 0 Interval= 3.400000 to 4.000000 Event_Count= 1 mvc003.c3d Interval= 1.000000 to 1.600000 Event_Count= 0 Interval= 1.600000 to 2.200000 Event_Count= 0 Interval= 2.200000 to 2.800000 Event_Count= 1 Interval= 2.800000 to 3.400000 Event_Count= 0 Interval= 3.400000 to 4.000000 Event_Count= 1 mvc004.c3d Interval= 1.000000 to 1.600000 Event_Count= 0 Interval= 1.600000 to 2.200000 Event_Count= 0 Interval= 2.200000 to 2.800000 Event_Count= 1 Interval= 2.800000 to 3.400000 Event_Count= 0 Interval= 3.400000 to 4.000000 Event_Count= 1 Global_Event_Counts Global_Event_Count= 1 Global_Event_Count= 1 Global_Event_Count= 3 Global_Event_Count= 1 Global_Event_Count= 3