Differences

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

--- visual3d:documentation:pipeline:metric_commands:metric_minimum [2024/06/19 13:37] – removed sgranger
+++ visual3d:documentation:pipeline:metric_commands:metric_minimum [2025/10/02 18:18] (current) – [Example] wikisysop
@@ Line 1: / Line 1: @@
+====== Metric Minimum ======
+====Overview====
+The **Metric Minimum** command computes the Minimum Value of a Signal and stores the value as a metric. It can be found within the **Pipeline Workshop** under **Metric**.
+=====Pipeline Command=====
+The syntax for the function is as follows:
+<code>
+Metric_Minimum
+! /RESULT_METRIC_FOLDER=PROCESSED
+/RESULT_METRIC_NAME=
+! /APPLY_AS_SUFFIX_TO_SIGNAL_NAME=FALSE
+/SIGNAL_TYPES=
+! /SIGNAL_FOLDER=ORIGINAL
+! /SIGNAL_NAMES=
+! /COMPONENT_SEQUENCE=
+/EVENT_SEQUENCE=
+/EXCLUDE_EVENTS=
+! /GENERATE_MEAN_AND_STDDEV=TRUE
+! /GENERATE_MEAN_AND_STDDEV_ACROSS_SUBJECTS=FALSE
+! /APPEND_TO_EXISTING_VALUES=FALSE
+! /CREATE_GLOBAL_MINIMUM=FALSE
+! /CREATE_TRIAL_MINIMUM=FALSE
+;
+</code>
+====Command Parameters====
+The Parameters for the function is as follows:
+|**Metric_Minimum**                                                                                              |                                                                                             |
+|/RESULT_METRIC_NAME=                                                                                         |The name of the metric signal created                                                        |
+|!/APPLY_AS_SUFFIX_TO_SIGNAL_NAME=FALSE                                                                       |Add a suffix to the signal name                                                              |
+|!/RESULT_METRIC_FOLDER=PROCESSED                                                                             |Name of results folder                                                                       |
+|/SIGNAL_TYPES=TARGET                                                                                         |                                                                                             |
+|/SIGNAL_NAMES=                                                                                               |Signal                                                                                       |
+|/SIGNAL_FOLDER=ORIGINAL                                                                                      |                                                                                             |
+|/COMPONENT_SEQUENCE                                                                         |Which component of the signal will be used for statistical analysis of the sequence.                          |
+|/[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Event_Sequence|EVENT_SEQUENCE]]=            |Specify the sequence of Events. Any number of Events can be entered (separated by +).        |
+|                                                                                                             |This specific sequence of events must be true for a metric to be computed.                   |
+|                                                                                                             |The metric is computed from the first event in the sequence to the last event in the sequence|
+|**/[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Exclude_Events|EXCLUDE_EVENTS]]=**        |If this event occurs between the first and last event, do not computed a metric              |
+|! /[[Visual3D:Documentation:Pipeline:Signal_Commands:GENERATE_MEAN_AND_STDDEV|Generate_Mean_and_Stddev]]=TRUE| Generate the mean and standard deviation of this metric across ranges and files             |
+|/Generate_Mean_and_Stddev_Across_Subjects                                                                    | Generate the mean and standard deviation of this metric across all subjects                 |
+|! /APPEND_TO_EXISTING_VALUES=FALSE                                                                           |Metrics can replace an existing signal or be appended to it.                                 |
+|! /CREATE_GLOBAL_MINIMUM=FALSE                                                                               |Create minimum value across all trials                                                       |
+|! /CREATE_TRIAL_MINIMUM=FALSE                                                                                |Create minimum value for this trial                                                          |
+====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.
+{{:MetricMinimumDlg5.jpg}}
+The dialog box allows you to assign values to the command parameters outlined above.
+====Example 1: Minimum Handspeed====
+In the following example, compute the Minimum Value of the derived signal **HANDSPEED** between the events **FRAME1** and **GO**, with any range containing the Event **SPEED_CHANGE** being ignored.
+<code>
+Metric_Minimum
+/RESULT_METRIC_NAME=_MEAN
+/APPLY_AS_SUFFIX_TO_SIGNAL_NAME=TRUE
+/RESULT_METRIC_FOLDER=PROCESSED
+/SIGNAL_TYPES=DERIVED
+/SIGNAL_NAMES=HANDSPEED
+/SIGNAL_FOLDER=PROCESSED
+/SIGNAL_COMPONENTS=ALL_COMPONENTS
+/EVENT_SEQUENCE=FRAME1 + GO
+/EXCLUDE_EVENTS=SPEED_CHANGE
+/GENERATE_MEAN_AND_STDDEV=TRUE
+/APPEND_TO_EXISTING_VALUES=FALSE
+! /CREATE_GLOBAL_MAXIMUM=FALSE
+;
+</code>
+====Example 2: Minimum GRF of Trail Foot in Baseball Swing====
+Here the **Metric Minimum** command is used to find minimum vertical ground reaction force value at the trail foot in a baseball swing.
+The command is as follows:
+<code>
+Metric_Minimum
+! /RESULT_METRIC_FOLDER=PROCESSED
+/RESULT_METRIC_NAME=Minimum_Trail_GRF
+! /APPLY_AS_SUFFIX_TO_SIGNAL_NAME=FALSE
+/SIGNAL_TYPES=FORCE
+/SIGNAL_FOLDER=ORIGINAL
+ /SIGNAL_NAMES=FP4
+/COMPONENT_SEQUENCE=Z
+/EVENT_SEQUENCE=
+/EXCLUDE_EVENTS=
+! /GENERATE_MEAN_AND_STDDEV=TRUE
+! /GENERATE_MEAN_AND_STDDEV_ACROSS_SUBJECTS=FALSE
+! /APPEND_TO_EXISTING_VALUES=FALSE
+! /CREATE_GLOBAL_MINIMUM=FALSE
+! /CREATE_TRIAL_MINIMUM=FALSE
+;
+</code>
+The resulting value for each swing can be found in the **METRIC:PROCESSED** folder and should look similar to below.
+{{:visual3d:documentation:pipeline:metric_commands:trail_grf1.png?600|}}