Differences

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

--- visual3d:documentation:pipeline:metric_commands:metric_median [2024/11/22 19:43] – wikisysop
+++ visual3d:documentation:pipeline:metric_commands:metric_median [2025/09/18 18:40] (current) – wikisysop
@@ Line 1: / Line 1: @@
 ====== Metric Median ======
-This command computes the Median Value of a Signal and store the value as a metric
+The **Metric Median** command computes the median 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:
-=====Command Syntax=====
 <code>
 Metric_Median
@@ Line 16: / Line 19: @@
 /EXCLUDE_EVENTS=
 ! /GENERATE_MEAN_AND_STDDEV=TRUE
+! /GENERATE_MEAN_AND_STDDEV_ACROSS_SUBJECTS=FALSE
 ! /APPEND_TO_EXISTING_VALUES=FALSE
-;
 </code>
-=====Parameters=====
+=====Command Parameters=====
+The Parameters for the function are as follows:
 |**Metric_Median**                                                                                      |                                                                               |
 |**/RESULT_METRIC_NAME=**                                                                               |Specify result name                                                                   |
@@ Line 36: / Line 42: @@
 |**/GENERATE_MEAN_AND_STDDEV=**                                                                         |Generate mean and stddev                                                                         |
-=====Example=====
+====Dialog====
-|**Metric_Median**                                                                                      |                                                                               |                                                                                                                                                                                                                                                              |
+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.
-|**/RESULT_METRIC_NAME=**                                                                               |_MEDIAN                                                                        |The type of signal created                                                                                                                                                                                                                                    |
-|**/APPLY_AS_SUFFIX_TO_SIGNAL_NAME=**                                                                   |True                                                                           |Specify the metric name to be the ORIGINAL signal plus a SUFFIX                                                                                                                                                                                               |
-|**/RESULT_METRIC_FOLDER=**                                                                             |PROCESSED                                                                      |                                                                                                                                                                                                                                                              |
-|**/SIGNAL_TYPES=**                                                                                     |DERIVED                                                                        |                                                                                                                                                                                                                                                              |
-|**/SIGNAL_NAMES=**                                                                                     |HANDSPEED                                                                      |Specify the Signal to be used                                                                                                                                                                                                                                 |
-|**/SIGNAL_FOLDER=**                                                                                    |PROCESSED                                                                      |                                                                                                                                                                                                                                                              |
-|**/SIGNAL_COMPONENTS=**                                                                                |ALL_COMPONENTS                                                                 |Specify the Signal components to be used (e.g. X, Y, Z or 0, 1, 2 etc)                                                                                                                                                                                        |
-|**/[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Event_Sequence|EVENT_SEQUENCE]]=**  |FRAME1 + GO                                                                    |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]]=**  |MAX_SPEED                                                                      |If this event occurs before the first and last event, do not compute a metric                                                                                                                                                                                 |
-|**/[[Visual3D:Documentation:Pipeline:Metric_Commands:SEQUENCE_PERCENT_START|SEQUENCE_PERCENT_START]]=**|Within the event sequence specify the beginning of the range as a percent      |                                                                                                                                                                                                                                                              |
-|**/[[Visual3D:Documentation:Pipeline:Metric_Commands:SEQUENCE_PERCENT_START|SEQUENCE_PERCENT_END]]=**  |Within the event sequence specify the end of the range as a percent            |                                                                                                                                                                                                                                                              |
-|TRUE                                                                                                   |Generate the mean and standard deviation of this metric across ranges and files|                                                                                                                                                                                                                                                              |
-|**/APPEND_TO_EXISTING_VALUES==**                                                                       |FALSE                                                                          |Do not Add these metric values to an existing metric                                                                                                                                                                                                          |
-|**/GENERATE_MEAN_AND_STDDEV=**                                                                         |                                                                                 |                               |
-|**;**                                                                                                  |                                                                               |
-                                                                                                                                                                                                                                |
+{{:MetricMedianDlg.png}}
-In the following example, compute the Median Value of the signal HANDSPEED
+The dialog box allows you to assign values to the command parameters outlined above.
-{{:MetricMedianDlg.png}}
+=====Example=====
+In the following example, compute the Median Value of the signal HANDSPEED:
+<code>
+Metric_Median
+/RESULT_METRIC_NAME=_MEDIAN
+/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=MAX_SPEED
+/SEQUENCE_PERCENT_START=
+/SEQUENCE_PERCENT_END]]=
+/GENERATE_MEAN_AND_STDDEV=TRUE
+/APPEND_TO_EXISTING_VALUES==FALSE
+;
+</code>
 NOTE: When you run a metric command, and tell it to create a global mean, it uses all the individual ranges to compute the overall mean (ie; one trial has 4 ranges, second trial has 1 range, the global mean is generated from the 5 values).