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 ;
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.
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.
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
;
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.
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 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 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 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