Differences

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

--- visual3d:documentation:pipeline:file_commands:recalc [2025/07/16 20:12] – wikisysop
+++ visual3d:documentation:pipeline:file_commands:recalc [2025/07/30 18:00] (current) – [Examples] wikisysop
@@ Line 3: / Line 3: @@
 ===== Overview =====
-The **Recalc** command is used to rebuild and update all model-based data for every file in the workspace. It performs a wide range of recalculations including models, landmarks, kinematics, kinetics and more.
+The **Recalc** command is used to update the workspace by re-processing key calculations after any model changes are made. This is often necessary when new segments or landmarks have been added, or when model-based computations may no longer be in sync with the current model structure.
-This command is especially important after making changes to:
+When executed, Recalc performs a comprehensive rebuild of the workspace by:
-  * A model definition
+  * Rebuilding all models
-  * A pipeline command affecting landmarks and forces
+  * Recomputing model-based landmarks and pose (position and orientation)
-  * Any updates that alter segment pose, orientation, or relationships.
+  * Reassigning force platforms
+  * Recomputing kinematics and kinetics
+  * Recomputing center of mass
+  * Updating report graphs and display windows.
-The command also executes the **user-defined Recalc pipeline**, which can include any custom commands (e.g. additional calculations or filtering) that the user wants to run automatically during recalculation.
+You can actually customize the commands that are executed when the Recalc is run. These are listed under the RECALC Pipeline, which can be found in the pipeline workshop or accessed via the button at the top of the Visual3D interface.
+For more information on customizing this process, visit the [[visual3d:documentation:pipeline:general_information:recalc_pipeline|RECALC Pipeline page]].
-----
+===== Pipeline Command =====
-When the command is executed (or the button is clicked), Visual3D performs the following in order:
+The command below is as seen in the Visual3D application. It does not take any parameters, as it is a standalone command.
-. Reprocess Force Platforms: If the setting for "Use Processed Analog" is enabled, force plate data is recomputed.
+<code>
+Recalc
-. Rebuild All Models: All models in the workspace are regenerated.
+;
+</code>
-. Compute Landmarks and Pose: All landmarks and segment positions/orientations are recalculated.
+===== Command Parameters =====
-. Assign Force Platforms: Forces are re-mapped to the correct foot segment based on location/contact.
+This command does not take any user-defined parameters, to customize what is processed with Recalc, visit the [[visual3d:documentation:pipeline:general_information:recalc_pipeline|RECALC Pipeline]] page as mentioned before.
-. Compute Assigned Forces: Net force and moment vectors are recalculated at the assigned foot.
-. Compute Kinematics and Kinetics: Joint angles, moments and forces are recalculated.
+===== Dialog =====
-. Compute Center of Mass: Whole-body center of mass is updated.
+There is no dialog box for this command due to it being a stand-alone function. The application interface alternative option is the recalc button on the toolbar:
-. Execute Recalc Pipeline: Any user-added commands in the Realc pipeline list box are executed (e.g., filters, custom metrics)
+{{:visual3d:documentation:pipeline:file_commands:toolbar_recalc_button.png?400|}}
-. Update UI and Report Graphs: Any new data is shown in the UI, and graphs are refreshed.
+===== Examples =====
-===== Pipeline Command =====
+The following examples will go through the use of the Recalc command in the Visual3D application.
-The command
+=== Example 1: Adding a Custom Foot Midpoint Landmark and Recalculating the Model ===
+This example walks through the process of defining a new custom landmark on the foot (midpoint between heel, MT1, and MT5), running the Recalc command to update the model, and then setting up for use in further analysis.
+Firstly, ensure that target markers are available in your workspace, so that joint positions can be determined. If they have not yet been created, use the [[visual3d:documentation:pipeline:signal_commands:create_target|Create Target]] command to ensure the required markers exist in the workspace.
+<code>
+Create_Target
+/SIGNAL_NAMES=[L.HEEL, L.MT1 + L.MT5]
+! /SIGNAL_DESCRIPTION=
+/EXPRESSION=
+! /INCLUDE_MOTIONFILE=TRUE
+! /INCLUDE_CALFILE=FALSE
+;
+</code>
+Step 2: Add the Midpoint Landmark to the Model and Recalc to ensure it is created.
+<code>
+Add_Landmark
+/LANDMARK_NAME=LF_MIDPT
+! /CALIBRATION_FILE=
+! /USER_GENERATED=TRUE
+/USE_PERCENTAGE=TRUE
+! /CALIBRATION_ONLY=FALSE
+/USE_TARGETS=TRUE
+! /SEGMENT_NAME=
+/TARGET_TYPES=TARGET+TARGET+TARGET
+/TARGET_NAMES=L.HEEL+L.MT1+L.MT5
+! /MCS_ML=0.0
+! /MCS_AP=0.0
+/MCS_AXIAL=0.5
+! /LANDMARK_LOCATION=
+! /REFERENCE_LOCATION_TYPE=
+! /REFERENCE_LOCATION_NAME=
+! /USE_REFERENCE_LOCATION=FALSE
+;
-The **Recalc** command is used to rebuild and update all model-based data for every file in the workspace. It performs a wide range of recalculations including models, landmarks, kinematics/kinetics, and more.
+Recalc
-This command is especially important making changes to:
+;
-  * A model definition
+</code>
-  * A pipeline command affecting landmarks or forces
-  * Any updates that alter segment pose, orientation, or relationships.
-The command also executes the user-defined RECALC pipeline, which can include any custom commands (e.g. additional calculations or filtering) that the user wants to run automatically during recalculation.
-When the Recalc command is executed (or the Recalc button in the GUI is clicked), Visual3D performs the following in order:
-. Reprocess Force Platforms
+Step 3: Use Landmark in Further Analysis
-If the setting for "use processed analog" is enabled, force plate data is recomputed.
+Here we compute the global maximum of the LF_MIDPT landmark's vertical component, representing peak foot height.
-. Rebuild All Models
-Recalculates the Workspace.
 <code>
-Recalc
+Metric_Maximum
+/RESULT_METRIC_NAME=Foot_Midpt_Max_Height
+! /APPLY_AS_SUFFIX_TO_SIGNAL_NAME=FALSE
+/SIGNAL_TYPES=LANDMARK
+/SIGNAL_NAMES=LF_MIDPT
+/COMPONENT_SEQUENCE=Y
+! /EVENT_SEQUENCE=
+/EXCLUDE_EVENTS=
+! /SEQUENCE_PERCENT_START=
+! /SEQUENCE_PERCENT_END=
+/CREATE_GLOBAL_MAXIMUM=TRUE
+! /GENERATE_MEAN_AND_STDDEV=TRUE
+! /APPEND_TO_EXISTING_VALUES=FALSE
 ;
 </code>
-Rebuilds any model(s) and any landmarks dependent on the model(s). The Recalc command also executes the [[Visual3D:Documentation:Pipeline:General_Information:RECALC_Pipeline|RECALC Pipeline]]. In addition if any changes have been made to the Events then Recalc will update any Report Graphs dependent on these events. As a general rule, anytime a change has been made to the EVENT LABELS or to PROCESSED signals that may effect the results in the report, it is always safest to RECALCULATE the workspace before printing the report or saving the CMO file.
-\\
+===== Notes =====
+  * Recalc ensures your model-based computations and workspace signals are always up-to-date.
+  * If you add or edit any landmarks or segments, you should run Recalc before further calculations or reports.
+  * The RECALC Pipeline can be customized to add user-defined commands that will always run when Recalc us executed.
+----
 [[Visual3D:Documentation:Pipeline:General_Information:Pipeline_Commands_Reference|Back to Pipeline Commands Reference]]