Differences

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

--- visual3d:documentation:modeling:functional_joints:defining_a_functional_joint [2024/06/19 12:48] – sgranger
+++ visual3d:documentation:modeling:functional_joints:defining_a_functional_joint [2026/09/11 18:36] (current) – Fixed formatting typo. richard
@@ Line 1: / Line 1: @@
-{{{{{{{{{{the properties of the functional joint are defined in the **model builder : landmarks : functional** tab
+====== Defining a Functional Joint ======
-==== step 1. switch to the landmarks tab in model builder mode ====
+This page covers Visual3D's interface for defining [[visual3d:documentation:modeling:landmarks:landmarks_overview#functional_landmarks|functional joint landmarks]]. See the [[visual3d:documentation:modeling:functional_joints:functional_joints|functional joints overview]] page for a general overview of the subject and visit the [[visual3d:tutorials:modeling:functional_joints|Create a Functional Joint at the Right Hip]] tutorial for a walkthrough of the process.
-functionaljointstab.jpg\\
+===== The Functional Landmarks Tab in Model Builder Mode =====
-the definition of the functional joints can be saved in an ini file for future use, but it is more common to simply save the model template because the functional joint definitions (and digitized point definitions) will automatically be saved to the template. the visual3d template will actually contain two versions of the functional joints. the first is the actual definition, and the second is the resulting explicit value that results from the functional joint computation. this second landmark is the one that is displayed in the viewer and can be used to define a segment or other landmarks.
-==== step 2. select one of the default landmark definitions from the combo box and create. ====
+Functional joint properties are defined in the **Landmarks : Functional** tab of the [[visual3d:documentation:definitions:model_builder_mode|Model Builder]].
-alternatively, you can specify a custom landmark name.
+{{:FunctionalJointsTab.jpg}}
-note that you can save and load functional joint definitions to a file for future use.
+The definition of the functional joints can be saved in an INI file for future use, but it is more common to simply save the Model Template because the functional joint definitions (and digitized point definitions) will automatically be saved to the template. The Visual3D template will actually contain two versions of the functional joints. The first is the actual definition, and the second is the resulting explicit value that results from the functional joint computation. This second landmark is the one that is displayed in the viewer and can be used to define a segment or other landmarks.
-functionaljointscombo.jpg\\
+===== Defining a Functional Joint Landmark =====
+The functional joint landmark will be created relative to the tracking segments/targets. Looking at the definition of the landmark that is created after computing the functional joint will show you these segments/targets.
-==== step 3. assign the markers/segments for the two segments surrounding the joint ====
+{{:FunctionalJointsDialog.jpg}}
-functionaljointsdialog.jpg\\
+There are two segments of interest:
+  * The **tracking** segment (originally the "reference segment"). Tracking targets are coloured blue in the viewer.
+  * The **other** segment, which is the segment that is moving relative to the tracking segment. Other Targets are coloured yellow.
+This dialog presents 3 options:
+  - Compute a second landmark that lies on the same axis as the joint computed. This is useful for joints that have only one degree of freedom because the functional joint in these cases can not be computed accurately.
+  - The minimum helical rotation is related to the algorithm and causes Visual3D to consider only a collection of postures in which the rotation from one posture to another posture is greater than the specified value.
+  - The algorithm uses all combinations of 3 frames of data in the selected range of frames. This can lead to an inordinate number of possible computations, which will slow the computation. The user can have Visual3D select randomly a restricted number of 3 frames of data
-the landmark will be created relative to the tracking segments/targets. for example, if you look at the definition of the landmark that is created after computing the functional joint, it will reference these segments/targets.
+==== Which targets/segments are actually used in the computation? ====
-the other segment/targets refers to the segment that is moving relative to the tracking segments.
+Regardless of whether the user selects Targets or Segments, Visual3D creates a technical coordinate system (TCS) to represent each segment for the computations. This is done to ensure that a segment exists because it is possible that the segment definition depends on the functional joint being computed. Visual3D chooses the three markers (from however many were selected) to be used for the TCS definition. Three markers define the vertices of a triangle. Visual3D searches for the triangle with the largest area, then uses these 3 targets. Visual3D then searches for the two vertices of the three selected that are the farthest apart, and these become the proximal and distal end of virtual segment from which the TCS is defined. The TCS is tracked, however, with all of the Targets that were selected.
-note that the tracking targets are colored blue in the viewer and the other targets are colored yellow.
+If the resulting landmark is defined relative to Targets (e.g. not to a segment), Visual3D uses the three markers that made up the TCS.
-originally, the tracking was referred to as the reference
+If the resulting landmark is defined relative to a segment, Visual3D transforms the landmark from the TCS into the Segment Coordinate System.
-there are 3 options available.
+{{:FunctionalJointsLandmarkDefinition.jpg}}
-  - compute a second landmark that lies on the same axis as the joint computed. this is useful for joints that have only one degree of freedom because the functional joint in these cases can not be computed accurately.
+In this case, Visual3D elected to define the landmark relative to RAS, LPP, and RPS of the possible 6 Targets used for tracking the segment.
-  - the minimum helical rotation is related to the algorithm and causes visual3d to consider only a collection of postures in which the rotation from one posture to another posture is greater than the specified value.
-  - the algorithm uses all combinations of 3 frames of data in the selected range of frames. this can lead to an inordinate number of possible computations, which will slow the computation. the user can have visual3d select randomly a restricted number of 3 frames of data
-==== which targets/segments are actually used in the computation? ====
+{{:FunctionalJointsLandmarkDefinitionSeg.jpg}}
-regardless of whether the user selects targets or segments, visual3d creates a technical coordinate system (tcs) to represent each segment for the computations. this is done to ensure that a segment exists because it is possible that the segment definition depends on the functional joint being computed.
+The same landmark can be defined relative to the pelvis segment rather than to markers. If you have created the landmark for use in defining segments (e.g. calibration only), it doesn't really matter whether you define the landmark relative to segments or landmarks. If you have created the landmark and would like to use it for tracking, it is advisable to define the landmark relative to a segment.
-visual3d chooses the three markers (from however many were selected) to be used for the tcs definition. three markers define the vertices of a triangle. visual3d searches for the triangle with the largest area, then uses these 3 targets. visual3d then searches for the two vertices of the three selected that are the farthest apart, and these become the proximal and distal end of virtual segment from which the tcs is defined. the tcs is tracked, however, with all of the targets that were selected.
+===== See Also =====
-if the resulting landmark is defined relative to targets (e.g. not to a segment), visual3d uses the three markers that made up the tcs.
+Once you have defined your functional joint landmarks you will need to complete [[visual3d:documentation:modeling:functional_joints:functional_joints_post_processing|post-processing]].
-if the resulting landmark is defined relative to a segment, visual3d transforms the landmark from the tcs into the segment coordinate system.
+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.
-functionaljointslandmarkdefinition.jpg\\
-in this case, visual3d elected to define the landmark relative to ras, lpp, and rps of the possible 6 targets used for tracking the segment.
-functionaljointslandmarkdefinitionseg.jpg\\
-the same landmark can be defined relative to the pelvis segment rather than to markers.
-if you have created the landmark for use in defining segments (e.g. calibration only), it doesn't really matter whether you define the landmark relative to segments or landmarks.
-if you have created the landmark and would like to use it for tracking, it is advisable to define the landmark relative to a segment.
-[[visual3d:tutorials:modeling:functional_joints|tutorial:functional_joints]]
-}}}}}}}}}}