Differences

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

--- visual3d:documentation:modeling:functional_joints:functional_joints_post_processing [2024/06/17 18:16] – created sgranger
+++ visual3d:documentation:modeling:functional_joints:functional_joints_post_processing [2026/09/11 18:58] (current) – Cleaned up page and reframed content to avoid duplicating the tutorial. richard
@@ Line 1: / Line 1: @@
+====== Functional Joints Post Processing ======
+After accumulating and [[visual3d:documentation:modeling:functional_joints:defining_a_functional_joint|defining]] [[visual3d:documentation:modeling:landmarks:landmarks_overview#functional_landmarks|functional joint landmarks]], it is necessary to post-process them from the [[visual3d:documentation:definitions:model_builder_mode|Model Builder]]'s Post-Process feature (click on the Post-Processing icon on the toolbar {{:ModelBuilderIcons.jpg}}).
-Computing functional joints manually from the post processing interface.
+===== Functional Joints =====
-====== Model Builder Post Processing ======
+All defined functional joint landmarks will appear in the top-half of the tab. Select a functional joint by checking the associated checkbox to make it active for the tab.
-After accumulating and defining the landmarks, select the Model Builder Post Process icon on the Toolbar
+{{:FunctionalJoints3.jpg}}
-[[ModelBuilderIcons.jpg]]\\
+Once you're ready, click on "Compute CHECKED Landmarks" or "Compute ALL Landmarks" to compute the locations of your functional joint landmarks.
+{{:FunctionalJoints5.jpg}}
-====== Add a New Motion File containing the functional movements ======
+===== Associated Motion Files =====
-It is possible to specify that a file already open in the Workspace can be used for the functional movement, or to load a C3D file from disk. Note that more than one file can be added to the list, but each landmark may only be assigned to one movement trial.
+It is possible to specify that a file already open in the [[visual3d:getting_started:workspace|workspace]] can be used for the functional movement, or to load a [[visual3d:documentation:c3d_signal_types:c3d_format|C3D file]] from disk. Note that more than one file can be added to the list, but each landmark may only be assigned to one movement trial.
-[[FunctionalJoints1.jpg]]
+{{:FunctionalJoints1.jpg}}
-Note that this landmark was created with an Event Sequence defining the range of frames of the motion trial to use.
+Motion trials need to be selected by checking the checkbox to be made active within the tab.
-Alternatively, the can select a start frame and an end frame for each landmark.
+{{:FunctionalJoints4.jpg}}
-The buttons "Set START Event to Current Frame" and "Set START Event to Current Frame" allow the user to play the animation of the movement trial and press the buttons at the appropriate frames.
+Note that the selected landmark was created with an Event Sequence defining the range of frames of the motion trial to use. If this is not the case, the user can select a **start frame** and an **end frame** for each landmark. The buttons "Set START Event to Current Frame" and "Set START Event to Current Frame" allow the user to play the animation of the movement trial and press the buttons at the appropriate frames. After loading the movement trials, they will appear in the bottom list box.
-After loading the movement trials, they will appear in the bottom list box.
+{{:FunctionalJoints2.jpg}}
-[[FunctionalJoints2.jpg]]
+===== Processing Results =====
-====== Select a functional landmark ======
-[[FunctionalJoints3.jpg]]
-====== Select the motion trial ======
-[[FunctionalJoints4.jpg]]
-====== Select the check box for the functional joint ======
-Select the button to Compute the Checked landmark.
-[[FunctionalJoints5.jpg]]
-====== Processing Results ======
-[[FunctionalJoints6.jpg]]
-\\
+{{:FunctionalJoints6.jpg}}
 The processing results from a functional will appear as above. First the name and parameters that were specified, then a series of intermediate steps in the algorithm in Visual3D that most people can safely ignore when there are no errors.
+==== Troubleshooting ====
+If Visual3D cannot compute a functional joint landmark, try these troubleshooting steps:
+  - Verify that the segments/target names in your functional joint definition also exist in your dynamic motion trial.
+  - Try redefining your functional joint to use more combinations.
+  - Try using a different dynamic motion trial (**note**, you should use a specific functional movement trial for this purpose and not a general movement trial).
+===== See Also =====
+Check out our documentation for [[visual3d:documentation:modeling:functional_joints:defining_a_functional_joint|defining functional joints]].
+Follow along with the [[visual3d:tutorials:modeling:functional_joints|Create a Functional Joint at the Right Hip]] tutorial for a complete walkthrough of the process.