Wiki Documentation Site

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » modeling » Functional Joints Overview » Defining a Functional Joint
visual3d:documentation:modeling:functional_joints:defining_a_functional_joint

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:modeling:functional_joints:defining_a_functional_joint [2024/07/17 15:45] – created sgrangervisual3d:documentation:modeling:functional_joints:defining_a_functional_joint [2026/09/11 18:36] (current) – Fixed formatting typo. richard
Line 1: Line 1:
 ====== Defining a Functional Joint ====== ====== Defining a Functional Joint ======
  
-The properties of the functional joint are defined in the **Model Builder : Landmarks : Functional** Tab+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.
  
-=== Step 1. Switch to the Landmarks Tab in Model Builder Mode ===+===== The Functional Landmarks Tab in Model Builder Mode =====
  
-{{:FunctionalJointsTab.jpg}}\\ +Functional joint properties are defined in the **Landmarks : Functional** tab of the [[visual3d:documentation:definitions:model_builder_mode|Model Builder]].
-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. ===+{{:FunctionalJointsTab.jpg}}
  
-Alternatively, you can specify a custom landmark name.+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.
  
-Note that you can save and load functional joint definitions to a file for future use.+===== Defining a Functional Joint Landmark =====
  
-{{:FunctionalJointsCombo.jpg}}\\+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.
  
 +{{:FunctionalJointsDialog.jpg}}
  
-=== Step 3. Assign the markers/segments for the two segments surrounding the joint === +There are two segments of interest: 
- +  * The **tracking** segment (originally the "reference segment"). Tracking targets are coloured blue in the viewer. 
-{{:FunctionalJointsDialog.jpg}}\\ +  * The **other** segment, which is the segment that is moving relative to the tracking segment. Other Targets are coloured yellow.
- +
- +
-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. +
- +
-The other segment/targets refers to the segment that is moving relative to the Tracking segments. +
- +
-Note that the Tracking Targets are colored blue in the viewer and the Other Targets are colored yellow. +
- +
-Originally, the Tracking was referred to as the Reference +
- +
-There are 3 options available.+
  
 +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.   - 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 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 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? ===+==== Which targets/segments are actually used in the computation? ====
  
-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. +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.
- +
-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.+
  
 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. 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.
Line 46: Line 34:
 If the resulting landmark is defined relative to a segment, Visual3D transforms the landmark from the TCS into the Segment Coordinate System. If the resulting landmark is defined relative to a segment, Visual3D transforms the landmark from the TCS into the Segment Coordinate System.
  
-{{:FunctionalJointsLandmarkDefinition.jpg}}\\ +{{: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. 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}}\\ +{{: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]]+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.
  
 +===== See Also =====
  
 +Once you have defined your functional joint landmarks you will need to complete [[visual3d:documentation:modeling:functional_joints:functional_joints_post_processing|post-processing]].
  
 +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.
visual3d/documentation/modeling/functional_joints/defining_a_functional_joint.1721231122.txt.gz · Last modified: by sgranger