Differences

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

--- visual3d:documentation:pipeline:metric_commands:metric_sum [2024/06/19 12:51] – sgranger
+++ visual3d:documentation:pipeline:metric_commands:metric_sum [2025/09/19 13:27] (current) – wikisysop
@@ Line 1: / Line 1: @@
-{{the **metric_sum** command will sum the signal components over a range from a start event to end event.
+====== Metric Sum ======
-the command details are:
+====Overview====
-|**metric_sum**                                                                                         |                                                                                                 |
+The **Metric_Sum** command will sum the signal components over a range from a Start event to End event. It can be found in the **Pipeline Workshop** under **Metric**.
-|**/signal_types=**                                                                                     |the type of signal to be processed                                                               |
-|**/signal_names=**                                                                                     |the name of the signal to be processed                                                           |
+====Pipeline Command====
-|**/signal_folder**                                                                                     |the folder of the signal to be processed                                                         |
-|**/signal_components=**                                                                                |the component of the signal to be processed                                                      |
+The command syntax is as follows:
-|**/[[visual3d:documentation:c3d_signal_types:event_label_data_type#event_sequence|event_sequence]]=**  |the start and end labels                                                                         |
-|**/[[visual3d:documentation:c3d_signal_types:event_label_data_type#exclude_events|exclude_events]]=**  |exclude ranges containing this event                                                             |
+<code>
-|**/[[visual3d:documentation:pipeline:metric_commands:sequence_percent_start|sequence_percent_start]]=**|within the event sequence specify the beginning of the range as a percent                        |
+Metric_Sum
-|**/[[visual3d:documentation:pipeline:metric_commands:sequence_percent_start|sequence_percent_end]]=**  |within the event sequence specify the end of the range as a percent                              |
+! /RESULT_METRIC_FOLDER=PROCESSED
-|**/result_metric_name=**                                                                               |the name of the resulting signal                                                                 |
+/RESULT_METRIC_NAME=
-|**/result_metric_folder=**                                                                             |the folder of the resulting signal.                                                              |
+! /APPLY_AS_SUFFIX_TO_SIGNAL_NAME=FALSE
-|**/apply_as_suffix_to_signal_name=**                                                                   |apply a suffix to the signal_name                                                                |
+/SIGNAL_TYPES=
-|**/generate_mean_and_stddev=**                                                                         |generate the mean and standard deviation both within each active file and across all active files|
+! /SIGNAL_FOLDER=ORIGINAL
-|**/append_to_existing_values=**                                                                        |append the results to an existing signal.                                                        |
+! /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
+;
+</code>
+====Command Parameters====
+The following table shows the command parameters seen above and their descriptions:
+|**Metric_Sum**                                                                                         |                                                                                                 |
+|**/Signal_Types=**                                                                                     |The type of signal to be processed                                                               |
+|**/Signal_Names=**                                                                                     |The name of the signal to be processed                                                           |
+|**/Signal_Folder**                                                                                     |The folder of the signal to be processed                                                         |
+|**/Signal_Components=**                                                                                |The component of the signal to be processed                                                      |
+|**/[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Event_Sequence|Event_Sequence]]=**  |The Start and End labels                                                                         |
+|**/[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Exclude_Events|Exclude_Events]]=**  |Exclude ranges containing this event                                                             |
+|**/[[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                              |
+|**/Result_Metric_Name=**                                                                               |The name of the resulting signal                                                                 |
+|**/Result_Metric_Folder=**                                                                             |The folder of the resulting signal.                                                              |
+|**/Apply_As_Suffix_To_Signal_Name=**                                                                   |Apply a suffix to the Signal_Name                                                                |
+|**/Generate_Mean_And_STDDEV=**                                                                         |Generate the mean and standard deviation both within each active file and across all active files|
+|**/Append_To_Existing_Values=**                                                                        |Append the results to an existing signal.                                                        |
 |**;**                                                                                                  |                                                                                                 |
-\\
+====Dialog====
-the **metric_sum** command dialog is below:
+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.
+{{:Metric_Sum.jpg}}
+The dialog box allows you to assign values to the command parameters outlined above.
-metric_sum.jpg
+==== Metric Sum Examples ====
-===== metric sum examples =====
+  - An example of the command **Metric_Sum** is found [[Visual3D:Documentation:Pipeline:Expressions:Expressions_Overview#Example:_Value_of_signal_at_an_analog_frame|here]]. This script uses metric_sum command to find a signal value at the analog frame rate. For details go to the page.
+  - An example can be found on [[Visual3D:Documentation:Statistics:Compute_Linear_Regression#Linear_Regression_Explicit_Meta-Command|Statistics Example 4#Linear_Regression_Explicit Meta-Command]] where the meta-command uses the **Metric_Sum** command to calculate a linear regression.
+  - Another example can be found on [[Visual3D:Documentation:Statistics:Meta_Command_for_Linear_Regression#Linear_Regression_with_Events_Meta-Command|Statistics Example 5#Linear Regression with Events Meta-Command]] where the meta-command uses the **Metric_Sum** command to calculate a linear regression.
-  - an example of the command **metric_sum** is found [[visual3d:documentation:pipeline:expressions:overview#example:_value_of_signal_at_an_analog_frame|here]]. this script uses metric_sum command to find a signal value at the analog frame rate. for details go to the page.
-  - an example can be found on [[visual3d:documentation:statistics:compute_linear_regression#linear_regression_explicit_meta-command|statistics example 4#linear_regression_explicit meta-command]] where the meta-command uses the **metric_sum** command to calculate a linear regression.
-  - another example can be found on [[visual3d:documentation:statistics:meta_command_for_linear_regression#linear_regression_with_events_meta-command|statistics example 5#linear regression with events meta-command]] where the meta-command uses the **metric_sum** command to calculate a linear regression.
-}}