Differences

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

--- visual3d:documentation:dialogs:program_options [2024/11/27 13:12] – wikisysop
+++ visual3d:documentation:dialogs:program_options [2025/09/12 15:16] (current) – [Target Colorization] wikisysop
@@ Line 1: / Line 1: @@
 ====== Program Options ======
-There are many options for controlling the default settings for Visual3D and for controlling the viewing options. The Program Options dialog can be accessed from the **Edit Menu item**
+There are many options for controlling the default settings for Visual3D and for controlling the viewing options. The Program Options dialog can be accessed from the **Edit Menu item** and contains 3 tabbed property pages: Default Folders, 3D Animation Options, and 3D View Options.
-{{:ProgramOptions.png?400}}\\
+{{:ProgramOptions.png?400}}
-There are 3 TAB dialogs in the program options property pages.
 ===== Default Folders =====
@@ Line 18: / Line 15: @@
   * Folders that change dynamically as the pipeline executes.
-|Default_Folders                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+^ Persistent Default Folders ^ ^
-|||Plugin Folder                 |Visual3D searches this folder for Visual3D Plugins. These plugins may be processing plugins that will appear in the list of Pipeline commands, or they may be Real_Time plugins that will appear in the options for Real-Time Streaming|\\ |Segment Graphics Folder       |The animation models associated with the model segments are stored in. If no path to an object file is selected in the Segment Properties dialog, Visual3D searches hear for the file.                                                 |\\ |Script Repository Folder      |Default folder for Pipelines. Used mainly for the [[Visual3D:Documentation:Pipeline:General_Information:Pipeline_Favorites|Pipeline Favorites]].                                                                                       |\\ |                              |VISUAL3D_DEFAULT_PIPELINE_FOLDER                                                                                                                                                                                                       |\\ |Default Data Folder           |The pipeline commands may refer to the default data folder as\\ VISUAL3D_DEFAULT_FOLDER\\ OR                                                                                                                                           |\\ |                              |VISUAL3D_DEFAULT_DATA_FOLDER                                                                                                                                                                                                           |\\ |Default Report Template Folder|Current default FOLDER for the report template.                                                                                                                                                                                        |\\ |                              |VISUAL3D_DEFAULT_REPORT_FOLDER                                                                                                                                                                                                         |\\ |Default Model Template Folder |Current default FOLDER for the standing trial.                                                                                                                                                                                         |\\ |                              |VISUAL3D_DEFAULT_MODEL_FOLDER                                                                                                                                                                                                          |\\ |Motion File Folder            |Current FOLDER for the motion trial. Reset every time a movement file is opened.                                                                                                                                                       |\\ |Report Template Folder        |Current FOLDER for the report template. Reset every time a Report Template is opened.                                                                                                                                                  |\\ |Model Template Folder         |Current default FOLDER for the standing trial. Reset every time a Hybrid Model is created.                                                                                                                                             |\\ \\ Example:\\ \\ **Set_Pipeline_Parameter_To_Folder_Path**\\ \\ /PARAMETER_NAME=DATA_FOLDER\\ \\ /PARAMETER_VALUE=VISUAL3D_DEFAULT_FOLDER\\ \\ **;**\\ \\ **Set_Pipeline_Parameter_To_Folder_Path**\\ \\ /PARAMETER_NAME=MODEL_FOLDER\\ \\ /PARAMETER_VALUE=VISUAL3D_DEFAULT_MODEL_FOLDER\\ \\ **;**\\ \\ To use this parameter in a command\\ \\ !Open all of the c3d files in a folder within the default folder\\ \\ [[Visual3D:Documentation:Pipeline:File_Commands:File_Open|File_Open]]\\ \\ /File_Name= ::DATA_FOLDER&/SUBJECT1/*walk*.c3d\\ \\ **;**\\ \\ ! Create a hybrid model and assign a model template from the default model folder\\ \\ [[Visual3D:Documentation:Pipeline:Model_Commands:Create_Hybrid_Model|Create_Hybrid_Model]]\\ \\ /CALIBRATION_FILE=::DATA_FOLDER&/SUBJECT1/*static.c3d\\ \\ **;**\\ \\ **Apply_Model_Template**\\ \\ /MODEL_TEMPLATE=::MODEL_FOLDER&GaitModel.mdh\\ \\ /CALIBRATION_FILE=::DATA_FOLDER&/SUBJECT1/*static.c3d\\ \\ **;**\\ \\ \\ **Note** that there is a pipeline command to set these options from a pipeline. This can be useful for setting the folders automatically for the user.\\ \\ **Set_Default_Folders**\\ \\ ! /PLUGINS=\\ \\ ! /SEGMENT_GRAPHICS=\\ \\ ! /PIPELINE=\\ \\ ! /REPORT_TEMPLATE=\\ \\ ! /MODEL_TEMPLATE=\\ \\ ! /MOTION_FILE=\\ \\ ! /DEFAULT_DATA=\\ \\ ! /CMO_LIBRARY_PATH=\\ \\ ! /DEFAULT_REPORT_TEMPLATE=\\ \\ ! /DEFAULT_MODEL_TEMPLATE=\\ \\ **;**  ||
+| Plugin Folder | Visual3D searches this folder for Visual3D Plugins. These plugins may be processing plugins that will appear in the list of Pipeline commands, or they may be Real_Time plugins that will appear in the options for Real-Time Streaming. |
+| Segment Graphics Folder |The animation models associated with the model segments are stored in. If no path to an object file is selected in the Segment Properties dialog, Visual3D searches hear for the file. |
+| Pipelines Folder | Default folder for Pipelines. Used mainly for the [[Visual3D:Documentation:Pipeline:General_Information:Pipeline_Favorites|Pipeline Favorites]]. Can be referred to as //VISUAL3D_DEFAULT_PIPELINE_FOLDER//. |
+^ Pipeline-related Default Folders ^ ^
+| Default Data Folder | Can be referred to as //VISUAL3D_DEFAULT_FOLDER// or //VISUAL3D_DEFAULT_DATA_FOLDER//. |
+| Default Report Template Folder | Current default FOLDER for the report template. Can be referred to as //VISUAL3D_DEFAULT_REPORT_FOLDER//. |
+| Default Model Template Folder | Current default FOLDER for the standing trial. Can be referred to as //VISUAL3D_DEFAULT_MODEL_FOLDER//. |
+^ User-interaction Folders ^ ^
+| Motion File Folder | Current FOLDER for the motion trial. Reset every time a movement file is opened. |
+| Report Template Folder | Current FOLDER for the report template. Reset every time a Report Template is opened. |
+| Model Template Folder | Current default FOLDER for the standing trial. Reset every time a Hybrid Model is created. |
-The Visual3D animation display, pictured below, allows you to visualize the movement of target markers, model segments (if defined), and other time-dependent phenomena such as ground reaction force (GRF) measured by force platforms.
+Default folder paths can be set using the [[visual3d:documentation:pipeline:other_commands:set_default_folders|Set_Default_Folders]] pipeline command.
-{{:3Dviewer.gif}}
+==== Setting Pipeline Parameters ====
-Visual3D’s extensive animation capabilities allow you to choose which of many elements are included in the display. The illustration shows a typical combination: global coordinate system (GCS) axes, force platforms, instantaneous GRF vector and butterfly showing how the GRF evolves through time, target markers, and the instantaneous pose of the model (represented in this case by the major bone structures corresponding to each of the modeled body segments). You can interact with the animation display to zoom, pan, and rotate it to any perspective you choose.
+These default folder paths can also be used in pipeline scripts as parameters.
-Note that the skeleton (representing the model) is the only part of the animation display pictured above, which will not appear if you have not yet associated the movement trial with a model. If all you do is open one movement trial, you can watch the markers move through space, observe their relationship to the position of any force platforms and the GRF they measure. This alone is a very useful tool for data quality control—if the animation doesn’t look right, your motion-capture data may be invalid.
+<code>
+Set_Pipeline_Parameter_To_Folder_Path
+/PARAMETER_NAME=DATA_FOLDER
+/PARAMETER_VALUE=VISUAL3D_DEFAULT_FOLDER
+;
-The 3D Animation Viewer is based on the OpenGL Graphics Library.
+Set_Pipeline_Parameter_To_Folder_Path
+/PARAMETER_NAME=MODEL_FOLDER
+/PARAMETER_VALUE=VISUAL3D_DEFAULT_MODEL_FOLDER
+;
+</code>
+To use these parameter in a command:
+<code>
+!Open all of the c3d files in a folder within the default folder
+File_Open
+/File_Name= ::DATA_FOLDER&/SUBJECT1/*walk*.c3d
+;
+! Create a hybrid model and assign a model template from the default model folder
+Create_Hybrid_Model
+/CALIBRATION_FILE=::DATA_FOLDER&/SUBJECT1/*static.c3d
+;
+Apply_Model_Template
+/MODEL_TEMPLATE=::MODEL_FOLDER&GaitModel.mdh
+/CALIBRATION_FILE=::DATA_FOLDER&/SUBJECT1/*static.c3d
+;
+</code>
 ===== 3D Animation Options =====
-{{:3DAnimationOptionsPropertyPage.png}}
+The Visual3D animation display, pictured below, allows you to visualize the movement of target markers, model segments (if defined), and other time-dependent phenomena such as ground reaction force (GRF) measured by force platforms.
+{{:3Dviewer.gif}}
+Visual3D’s extensive animation capabilities allow you to choose which of many elements are included in the display. The illustration shows a typical combination: global coordinate system (GCS) axes, force platforms, instantaneous GRF vector and butterfly showing how the GRF evolves through time, target markers, and the instantaneous pose of the model (represented in this case by the major bone structures corresponding to each of the modeled body segments). You can interact with the animation display to zoom, pan, and rotate it to any perspective you choose. Note that the skeleton (representing the model) is the only part of the animation display pictured above, which will not appear if you have not yet associated the movement trial with a model. If all you do is open one movement trial, you can watch the markers move through space, observe their relationship to the position of any force platforms and the GRF they measure. This alone is a very useful tool for data quality control—if the animation doesn’t look right, your motion-capture data may be invalid.
+The 3D Animation Viewer is based on the OpenGL Graphics Library and its settings can be modified in the 3D Animation Options tab.
+{{:3DAnimationOptionsPropertyPage.png?800x}}
 Define the sensitivity of the mouse; e.g. the responsiveness of the mouse in the 3D viewer.
@@ Line 58: / Line 100: @@
 This property pages contains a number of toggle settings for different view options in the animation window.
-|3D View Options                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+|3D View Options|
-||     Force Platforms                           |\\ |Toggles the visibility of the force platforms  |\\ \\ |     Ground Reaction Force Butterfly                                                                                                                                                                                   |\\ |{{:GRFButterflyOff.jpg}} {{:GRFButterflyOn.jpg}}\\ \\ Toggles the visibility of the ground reaction force butterfly.  |\\ \\ |     Ground Reaction Force Vector                            |\\ |Toggles the visibility of the ground reaction force vector.  |\\ \\ |     Ground Reaction Force COP                                           |\\ |Toggles the visibility of the ground reaction force Center of Pressure.  |\\ \\ ||**Ground Reaction Force Free Moment**       |Toggles the visibility of the ground reaction force Free Moment.                                      |\\ |***Segment Assigned (Custom/Combined)**     |Displays Assigned Forces.                                                                             |\\ |**Force Structures/Projected Forces**       |Displays Force Structures.                                                                            |\\ |**View Assigned Force Segments**            |Colors all segments that have been assigned to a force.                                               |\\ |**Lab/Floor**                               |Toggles the visibility of the laboratory and floor.                                                   |\\ |**Lab Axes**                                |Toggles drawing the laboratory coordinate system axes.                                                |\\ |**Lab Axes in Model Builder**               |Toggles drawing the laboratory coordinate system axes in Model Builder Mode.                          |\\ |**Background Black/White**                  |Draws the 3D animation with either a black or white background.                                       |\\ |**Targets**                                 |Toggles drawing of targets.                                                                           |\\ |**Color Targets by Residual**               |Color Targets by the magnitude of the Residual component.                                             |\\ |**Landmarks**                               |Toggles drawing of Landmarks.                                                                         |\\ |**Joints**                                  |Toggles drawing the "Joints" used for the Inverse Dynamics.                                           |\\ |**Local Targets (in LCS)**                  |Toggles drawing the expected location of the markers as defined by the model.                         |\\ |**Model Center of Mass**                    |Toggles drawing the Center of Mass of the Model.                                                      |\\ |**Muscles**                                 |Toggles drawing Muscles. Muscles can be drawn as lines or cylinders.                                  |\\ |**Kinetic Segments**                        |Toggles drawing Kinetic Segments.                                                                     |\\ |**Kinematic Only Segments**                 |Toggles drawing Kinematic Only Segments.                                                              |\\ |**Display Segment Colors**                  |Toggles the color of segment based on an assigned signal.                                             |\\ |**Display Segment Inertial Geometry**       |Toggles drawing the Segment Geometry.                                                                 |\\ |**Segments as Stick Figures**               |Toggles drawing Kinetic Segments as Stick Figures.                                                    |\\ |**Kinematic Only Segments as Stick Figures**|Toggles drawing Kinematic Only Segments as Stick Figures.                                             |\\ |**Segment Coordinate System Axes**          |Toggles the visibility of the SCS. Specifies the location to draw the axis as origin or center of mass|  ||
+|**Force Platforms**                          |Toggles the visibility of the force platforms  |
+|**Ground Reaction Force Butterfly**  |Toggles the visibility of the ground reaction force butterfly \\ {{:GRFButterflyOff.jpg}} {{:GRFButterflyOn.jpg}}  |
+|**Ground Reaction Force Vector**                            |Toggles the visibility of the ground reaction force vector. |
+|**Ground Reaction Force COP**                                           | Toggles the visibility of the ground reaction force Center of Pressure.  |
+|**Ground Reaction Force Free Moment**       |Toggles the visibility of the ground reaction force Free Moment.                                      |
+|***Segment Assigned (Custom/Combined)**     |Displays Assigned Forces.                                                                             |
+|**Force Structures/Projected Forces**       |Displays Force Structures.                                                                            |
+|**View Assigned Force Segments**            |Colors all segments that have been assigned to a force.                                               |
+|**Lab/Floor**                               |Toggles the visibility of the laboratory and floor.                                                   |
+|**Lab Axes**                                |Toggles drawing the laboratory coordinate system axes.                                                |
+|**Lab Axes in Model Builder**               |Toggles drawing the laboratory coordinate system axes in Model Builder Mode.                          |
+|**Background Black/White**                  |Draws the 3D animation with either a black or white background.                                       |
+|**Targets**                                 |Toggles drawing of targets.                                                                           |
+|**Color Targets by Residual**               |Color Targets by the magnitude of the Residual component.                                             |
+|**Landmarks**                               |Toggles drawing of Landmarks.                                                                         |
+|**Joints**                                  |Toggles drawing the "Joints" used for the Inverse Dynamics.                                           |
+|**Local Targets (in LCS)**                  |Toggles drawing the expected location of the markers as defined by the model.                         |
+|**Model Center of Mass**                    |Toggles drawing the Center of Mass of the Model.                                                      |
+|**Muscles**                                 |Toggles drawing Muscles. Muscles can be drawn as lines or cylinders.                                  |
+|**Kinetic Segments**                        |Toggles drawing Kinetic Segments.                                                                     |
+|**Kinematic Only Segments**                 |Toggles drawing Kinematic Only Segments.                                                              |
+|**Display Segment Colors**                  |Toggles the color of segment based on an assigned signal.                                             |
+|**Display Segment Inertial Geometry**       |Toggles drawing the Segment Geometry.                                                                 |
+|**Segments as Stick Figures**               |Toggles drawing Kinetic Segments as Stick Figures.                                                    |
+|**Kinematic Only Segments as Stick Figures**|Toggles drawing Kinematic Only Segments as Stick Figures.                                             |
+|**Segment Coordinate System Axes**          |Toggles the visibility of the SCS. Specifies the location to draw the axis as origin or center of mass|
-===== Segment Colorization =====
+==== Segment Colorization ====
 It is possible to color a segment model or a muscle object based on a signal value.
 |Segment Colorization (more...)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-||A right mouse click in the animation window will cause the following popup to appear. Select **Map Segment Color to a Signal Value**\\ \\ {{:MapSegmentColorMenu.jpg}}\\ \\ \\ the following dialog allows the selection of a Visual3D model object and the associated signal\\ \\ {{:MapColorsToSignalValuesDlg.jpg}}\\ \\ \\ In the above dialog the magnitude of the **Right Hip Power** signal is used to color the **Right Thigh Segment.** Note that it is important to select the **Apply Colorization** button after the segment and signal have been selected.\\ \\ {{:ColoredRightThigh.jpg}}\\ \\ \\ The resulting snapshot from the animation shows the colored right thigh.  ||
+|A right mouse click in the animation window will cause the following popup to appear. Select **Map Segment Color to a Signal Value**\\ \\ {{:MapSegmentColorMenu.jpg}}\\ \\ \\ The following dialog allows the selection of a Visual3D model object and the associated signal\\ \\ {{:MapColorsToSignalValuesDlg.jpg}}\\ \\ \\ In the above dialog the magnitude of the **Right Hip Power** signal is used to color the **Right Thigh Segment.** Note that it is important to select the **Apply Colorization** button after the segment and signal have been selected.\\ \\ {{:ColoredRightThigh.jpg}}\\ \\ \\ The resulting snapshot from the animation shows the colored right thigh.  |
-===== Target Colorization =====
+==== Target Colorization ====
 The motion capture markers are colored based on the TARGET residual value.
 |Target Colorization (more...)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
-||Residual= 0 => Red\\ Maximum Residual in the file => Yellow\\ Minimum Residual in the file => Green\\ \\ {{:ColoredTargets.jpg}}\\ \\ \\ **Note** that if the TARGETS have been processed, the color of the markers will always be green because the residual has no meaning for a PROCESSED signal.\\ \\ {{:UseProcessedTargets.jpg}}\\ \\ \\ **Note** that an exception is when the option to **Use ProcessTargets for Model/Segment/LinkModeBased Items** is unselected because this results in the ORIGINAL signals being used for the animation as well as the computations.  ||
+|Residual= 0 => Red\\ Maximum Residual in the file => Yellow\\ Minimum Residual in the file => Green\\ \\ {{:ColoredTargets.jpg}}\\ \\ \\ **Note** that if the TARGETS have been processed, the color of the markers will always be green because the residual has no meaning for a PROCESSED signal.\\ \\ {{:UseProcessedTargets.jpg}}\\ \\ \\ **Note** that an exception is when the option to **Use ProcessTargets for Model/Segment/LinkModeBased Items** is unselected because this results in the ORIGINAL signals being used for the animation as well as the computations.  |