HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » pipeline » file_commands » Recalc
visual3d:documentation:pipeline:file_commands:recalc

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
visual3d:documentation:pipeline:file_commands:recalc [2025/07/30 16:00] – wikisysopvisual3d:documentation:pipeline:file_commands:recalc [2025/07/30 18:00] (current) – [Examples] wikisysop
Line 13: Line 13:
   * Updating report graphs and display windows.   * Updating report graphs and display windows.
  
-You can actually customize the commands that are executed when the Recalc is run. These are listed under the RECALC Pipeline, whic+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]].
-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. +
- +
-This command is especially important after making changes to: +
-  * A model definition +
-  * A pipeline command affecting landmarks and 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.  +
- +
- +
-==== Understanding the Recalc Pipeline ==== +
- +
-When the command is executed (or the button is clicked), Visual3D performs the following in order: +
- +
-1. Reprocess Force Platforms: If the setting for "Use Processed Analog" is enabled, force plate data is recomputed. +
- +
-2. Rebuild All Models: All models in the workspace are regenerated. +
- +
-3. Compute Landmarks and Pose: All landmarks and segment positions/orientations are recalculated. +
- +
-4. Assign Force Platforms: Forces are re-mapped to the correct foot segment based on location/contact. +
- +
-5. Compute Assigned Forces: Net force and moment vectors are recalculated at the assigned foot. +
- +
-6. Compute Kinematics and Kinetics: Joint angles, moments and forces are recalculated. +
- +
-7. Compute Center of Mass: Whole-body center of mass is updated. +
- +
-8. Execute Recalc Pipeline: Any user-added commands in the Realc pipeline list box are executed (e.g., filters, custom metrics) +
- +
-9. Update UI and Report Graphs: Any new data is shown in the UI, and graphs are refreshed.+
  
 ===== Pipeline Command ===== ===== Pipeline Command =====
  
-The command below is as seen on the Visual3D application, it has many parameters as there are many options to manipulate this command.+The command below is as seen in the Visual3D application. It does not take any parameters, as it is a standalone command.
  
 <code> <code>
Line 60: Line 29:
 ===== Command Parameters ===== ===== Command Parameters =====
  
-This command does not have any parameters. It will always execute the default and user-defined Recalc processes on all files in the workspace.+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. 
  
 ===== Dialog ===== ===== Dialog =====
Line 72: Line 42:
 The following examples will go through the use of the Recalc command in the Visual3D application. The following examples will go through the use of the Recalc command in the Visual3D application.
  
-=== Example 1: Recalculate model and landmark changes === 
  
-! Create left foot midpoint landmark and then rebuild model-based data+=== 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 Add_Landmark
 /LANDMARK_NAME=LF_MIDPT /LANDMARK_NAME=LF_MIDPT
 ! /CALIBRATION_FILE= ! /CALIBRATION_FILE=
 ! /USER_GENERATED=TRUE ! /USER_GENERATED=TRUE
-! /USE_PERCENTAGE=FALSE+/USE_PERCENTAGE=TRUE
 ! /CALIBRATION_ONLY=FALSE ! /CALIBRATION_ONLY=FALSE
-! /USE_TARGETS=FALSE+/USE_TARGETS=TRUE
 ! /SEGMENT_NAME= ! /SEGMENT_NAME=
-! /TARGET_TYPES= +/TARGET_TYPES=TARGET+TARGET+TARGET 
-! /TARGET_NAMES=+/TARGET_NAMES=L.HEEL+L.MT1+L.MT5
 ! /MCS_ML=0.0 ! /MCS_ML=0.0
 ! /MCS_AP=0.0 ! /MCS_AP=0.0
-! /MCS_AXIAL=0.0+/MCS_AXIAL=0.5
 ! /LANDMARK_LOCATION= ! /LANDMARK_LOCATION=
 ! /REFERENCE_LOCATION_TYPE= ! /REFERENCE_LOCATION_TYPE=
Line 94: Line 81:
 ; ;
  
 +Recalc
  
 +;
 +</code>
  
 +Step 3: Use Landmark in Further Analysis 
  
-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. +Here we compute the global maximum of the LF_MIDPT landmark's vertical component, representing peak foot height.
- +
-This command is especially important making changes to: +
-  * A model definition +
-  * 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: +
- +
-1. Reprocess Force Platforms +
- +
-If the setting for "use processed analog" is enabled, force plate data is recomputed. +
- +
-2. Rebuild All Models    +
- +
-Recalculates the Workspace.+
  
 <code> <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> </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]] [[Visual3D:Documentation:Pipeline:General_Information:Pipeline_Commands_Reference|Back to Pipeline Commands Reference]]
  
  
  
visual3d/documentation/pipeline/file_commands/recalc.1753891217.txt.gz · Last modified: 2025/07/30 16:00 by wikisysop