Differences

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

--- visual3d:documentation:pipeline:general_information:recalc_pipeline [2024/06/19 12:51] – sgranger
+++ visual3d:documentation:pipeline:general_information:recalc_pipeline [2024/07/17 15:45] (current) – created sgranger
@@ Line 1: / Line 1: @@
-{{the pipeline processing dialog contains two buttons above the middle list box.
+====== RECALC Pipeline ======
-the **main pipeline** refers to the pipeline that has been loaded manually by the user.
+The pipeline processing dialog contains two buttons above the middle list box.
-the **cmo recalc scrip**t by default contains the linkmodel based calculation definitions. the user can, however, add pipeline commands to this list box manually. these commands will be processed whenever the recalc button is executed.
+The **Main Pipeline** refers to the pipeline that has been loaded manually by the user.
-**note:** that any items that are in the **cmo recalc script** when a report template is saved are stored in the report template.
+The **CMO Recalc Scrip**t by default contains the LINKMODEL based calculation definitions. The user can, however, add pipeline commands to this list box manually. These commands will be processed whenever the RECALC button is executed.
-==== what processing happens ====
+**Note:** that any items that are in the **CMO Recalc Script** when a Report Template is saved are stored in the report template.
-when the recalc button is pressed. the following processing occurs:
+=== What processing happens ===
-  - if **use processed analog** is set, re-process force platforms.
+When the RECALC button is pressed. The following processing occurs:
-  - rebuild all models in the workspace
-  - compute landmarks and model pose (e.g. position and orientation of all segments) for all #files in the workspace
-  - assign force platforms to segments
-  - compute assigned forces
-  - compute kinematics
-  - compute kinetics
-  - compute center of mass.
-  - execute the recalc pipeline
-  - update the display dialogs for any new data
-  - recompute the report graphs
-link_model_based signals in the report are always recalculated. link_model_based signals not in the report are not recalculated.
+  - If **use processed analog** is set, re-process force platforms.
+  - Rebuild all models in the Workspace
+  - Compute landmarks and model pose (e.g. position and orientation of all segments) for all #files in the Workspace
+  - Assign Force Platforms to Segments
+  - Compute Assigned Forces
+  - Compute Kinematics
+  - Compute Kinetics
+  - Compute Center of Mass.
+  - Execute the RECALC pipeline
+  - Update the display dialogs for any new data
+  - Recompute the Report graphs
-derived, metric and other signals are not recalculated by default. these calculations can be placed into the recalc pipeline by generating the pipeline you desire, save the pipeline, switch to the cmo recalc pipeline (using the radio button, shown below), click the 'open pipeline' button and append the saved pipeline to the existing recalc pipeline.
+LINK_MODEL_BASED signals in the report are always recalculated. LINK_MODEL_BASED signals not in the report are not recalculated.
-recalc_pipeline.jpg
+DERIVED, METRIC and other signals are not recalculated by default. These calculations can be placed into the recalc pipeline by generating the pipeline you desire, save the pipeline, switch to the CMO recalc pipeline (using the radio button, shown below), click the 'Open Pipeline' button and append the saved pipeline to the existing recalc pipeline.
-by adding the calculations to the recalc pipeline, these will be recalculated when the recalc button is pressed. the recalc pipeline is saved in the .cmo file so it will always be there, and it is also saved in the report template so that when you open the report the items which should be recalculated (or calculated for a first time) are performed.
-==== saving the recalc pipeline ====
+{{:RECALC_Pipeline.jpg}}
+By adding the calculations to the recalc pipeline, these will be recalculated when the recalc button is pressed. The recalc pipeline is saved in the .cmo file so it will always be there, and it is also saved in the report template so that when you open the report the items which should be recalculated (or calculated for a first time) are performed.
-if the button is checked to display the recalc pipeline, the pipeline list box will be shaded pink.
+=== Saving the Recalc Pipeline ===
-selecting the button to save the pipeline will save the contents of the recalc pipeline.
+If the button is checked to display the Recalc pipeline, the pipeline list box will be shaded pink.
-selecting the button to open the pipeline will either replace or append the existing recalc pipeline.
+Selecting the button to save the pipeline will save the contents of the Recalc pipeline.
-deleting the recalc pipeline will remove the recalc pipeline from the workspace.
+Selecting the button to open the pipeline will either replace or append the existing Recalc Pipeline.
-==== opening a report template ====
+Deleting the Recalc pipeline will remove the Recalc pipeline from the workspace.
-when a report template is added to the workspace, all of the report graphs are deleted and all of the model based data definitions contained in the report template are appended to the **cmo recalc script**. for design reasons we elected not to delete the existing model based data because we felt it was easier for users to delete entries from the **cmo recalc script** than to re-create the model based data that they created before opening the report template. however, when the **recalc** button is pressed, the old compute model based signals will be **removed** from the recalc pipeline.
+=== Opening a Report Template ===
-==== recalc pipeline processing acts on the active files ====
+When a report template is added to the Workspace, all of the report graphs are deleted and all of the model based data definitions contained in the report template are appended to the **CMO Recalc Script**. For design reasons we elected not to delete the existing model based data because we felt it was easier for users to delete entries from the **CMO Recalc Script** than to re-create the model based data that they created before opening the report template. However, when the **RECALC** button is pressed, the old Compute Model Based signals will be **removed** from the RECALC pipeline.
-by default, all_files are active for the recalc pipeline.
+=== Recalc Pipeline Processing acts on the Active Files ===
-it is possible to "trick" visual3d by inserting select_active_file commands into the recalc pipeline, which allows you to selectively determine which files are being re-processed, but you need to be careful because the recalc pipeline is a critical part of the report template, so only do this when you want the changes to persist in your report template.
+By default, ALL_FILES are active for the Recalc Pipeline.
-==== removing a signal from the workspace ====
+It is possible to "trick" Visual3D by inserting Select_Active_File commands into the RECALC pipeline, which allows you to selectively determine which files are being re-processed, but you need to be careful because the RECALC pipeline is a critical part of the Report Template, so only do this when you want the changes to persist in your report template.
-if a signal is defined in the recalc pipeline, removing (or) renaming the signal in the data tree won't do the trick. as soon as the recalc pipeline is executed the signal will re-appear. you need to remove the signal from both the recalc pipeline and the data tree.
+=== Removing a signal from the Workspace ===
-all model based signals are automatically added to the recalc pipeline when they are created.
+If a signal is defined in the RECALC pipeline, removing (or) renaming the signal in the data tree won't do the trick. As soon as the RECALC pipeline is executed the signal will re-appear. You need to remove the signal from both the RECALC pipeline and the data tree.
-visual3d checks for duplicate entries in the recalc pipeline, but it is possible that a user can inadvertently add duplicates to the pipeline.
+All model based signals are automatically added to the RECALC pipeline when they are created.
-==== warning about editing the recalc pipeline ====
+Visual3D checks for duplicate entries in the RECALC pipeline, but it is possible that a user can inadvertently add duplicates to the pipeline.
-removing an item from the recalc pipeline does not remove the item from the data tree (e.g. the workspace). the signal in the data tree no longer has a definition, however, so changing the properties of the model, which would normally change the related model based signals, will not modify the signal as expected.
+=== Warning about editing the RECALC pipeline ===
-if you aren't sure, you can save the cmo file, then remove all the model based signals from the data tree, select recalc and see what signals didn't re-appear.
+Removing an item from the RECALC pipeline does not remove the item from the data tree (e.g. the Workspace). The signal in the data tree no longer has a definition, however, so changing the properties of the model, which would normally change the related model based signals, will not modify the signal as expected.
-if you are missing a specific signal, re-open the saved cmo file and check the history of the signal missing from the recalc pipeline. version 4.5 of visual3d allows you to copy the history (e.g. the model based definition), so you can paste it into the recalc pipeline.
+If you aren't sure, you can save the cmo file, then remove all the model based signals from the data tree, select RECALC and see what signals didn't re-appear.
-==== modifying the definition of model based items in the recalc pipeline ====
+If you are missing a specific signal, re-open the saved cmo file and check the history of the signal missing from the RECALC pipeline. Version 4.5 of Visual3D allows you to copy the history (e.g. the model based definition), so you can paste it into the RECALC pipeline.
-you can edit the commands in the recalc pipeline directly. in the pipeline dialog, select the button (check box) to make the recalc pipeline editable and edit a command.
+=== Modifying the definition of model based items in the RECALC pipeline ===
+You can edit the commands in the RECALC pipeline directly. In the pipeline dialog, select the button (check box) to make the RECALC pipeline editable and edit a command.
+You can also select Compute Model Based Data under the Model menu option, and edit the definition there. Visual3D will automatically search for a model based signal of the same name in the data tree and replace the properties.
-you can also select compute model based data under the model menu option, and edit the definition there. visual3d will automatically search for a model based signal of the same name in the data tree and replace the properties.
-}}