Differences

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

--- visual3d:documentation:pipeline:model_commands:get_vicon_model_metric [2024/07/16 16:59] – removed sgranger
+++ visual3d:documentation:pipeline:model_commands:get_vicon_model_metric [2025/03/18 17:54] (current) – [Example] wikisysop
@@ Line 1: / Line 1: @@
+====== Get Vicon Model Metric ======
+Extracting metric values from Vicon's .MP file into Visual3D Subject/Data Metrics
+===== Pipeline Command =====
+<code>
+Get_Vicon_Model_Metric
+! /CALIBRATION_FILE=
+! /MP_FILE_NAME=
+! /METRIC_NAMES=
+! /METRIC_VALUES=
+;
+</code>
+/Calibration_File refers to the Link Model in which the metrics will be stored
+If Calibration_File is empty or =*, the current link model is used.
+/MP_File_Name refers to the Vicon MP file
+If MP_File_Name is empty, the user is prompted for the filename.
+MP_File_Name refers to the full path name of the file.
+/Metric_Names and /Metric_Values are optional
+If Metric_Names is empty or =*, all Metric_Names in the .mp file are selected
+If Metric_Values is populated, this is the default value of Metric_Names and is used if Metric_Names does not exist in the .MP file.
+===== Example =====
+Given an MP file containing the following information:
+<code>
+$RKnee_Width = 150.0
+$RFoot_Width = 100.0
+$LKnee_Width = 150.0
+$LFoot_Width = 100.0
+</code>
+and the command
+<code>
+Get_Vicon_Model_Metric
+/CALIBRATION_FILE=*
+/MP_FILE_NAME=
+/METRIC_NAMES=
+/METRIC_VALUES=
+/NAME_PREFIX=
+;
+</code>
+  * The current active model will be used.
+  * The user will be prompted for the MP file name.
+  * All 4 metric values in the MP file will be added to the model subject metrics
+  * No prefix will be added to the names.
+<code>
+Get_Vicon_Model_Metric
+/CALIBRATION_FILE=
+/MP_FILE_NAME=
+/METRIC_NAMES=RHip_Radius
+/DEFAULT_METRIC_VALUES=0.5*DISTANCE(RIGHT_HIP,LEFT_HIP)
+/NAME_PREFIX=
+;
+</code>
+  * RHip_Radius is not part of the MP file
+  * A default metric value has been provided
+  * A model metric RHip_Radius will be created (or modified)
+  * The value of the metric will be the expression 0.5*DISTANCE(RIGHT_HIP,LEFT_HIP)