Differences

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

--- visual3d:documentation:modeling:functional_joints:example_-_functional_knee [2024/06/19 12:48] – sgranger
+++ visual3d:documentation:modeling:functional_joints:example_-_functional_knee [2025/07/30 18:55] (current) – sgranger
@@ Line 1: / Line 1: @@
-{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{\\
+====== Example - Functional Knee ======
-when defining the functional knee joint, the calculation defines the axis of rotation, but not the location on the axis.\\
-\\
-two additional landmarks (rknemed & lknemed) must be created off the position of the mediolateral knee targets.\\
-\\
-[[https://www.has-motion.com/download/functionaljoints.zip|sample files]] for this tutorial may be downloaded.\\
+When defining the functional knee joint, the calculation defines the axis of rotation, but not the location on the axis. \\
+Two additional landmarks (RKneMed & LKneMed) must be created off the position of the mediolateral knee targets. \\
+[[https://www.has-motion.com/download/FunctionalJoints.zip|Sample files]] for this tutorial may be downloaded. \\
-) this tutorial will use the **static.c3d** and **functional knee.c3d** files.\\
+) This tutorial will use the **Static.c3d** and **Functional Knee.c3d** files. \\
+) The Functional Hip.c3d file is used for the [[Visual3D:Documentation:Modeling:Functional_Joints:Example_-_Functional_Hip|Functional Hip Tutorial]]. \\
+) FunctionalJoints_Hip_Knee.cmo contains a static trial with both the functional hip and knee defined. \\
-) the functional hip.c3d file is used for the [[visual3d:documentation:modeling:functional_joints:example_-_functional_hip|functional hip tutorial]].\\
+**The calculation of functional joints is described [[Visual3D:Documentation:Modeling:Functional_Joints:Functional_Joints|here]].** \\
-) functionaljoints_hip_knee.cmo contains a static trial with both the functional hip and knee defined.\\
-\\
+===== Load Static Trial =====
-**the calculation of functional joints is described [[visual3d:documentation:modeling:functional_joints:functional_joints|here]].**\\
+|1. From the **Model** menu, select **Create -> Hybrid Model from C3D file.** \\ 2. A dialog titled **Select the calibration file for the new model** will appear; \\ Select //Static.c3d// Click **Open.** | {{:CreateStatic.jpg}}|
-====== load static trial ======
+===== Create Functional Joint =====
-|1. from the **model** menu, select **create -> hybrid model from c3d file.**\\ \\ 2. a dialog titled **select the calibration file for the new model** will appear;\\ \\ \\ select //static.c3d// click **open.**  |  createstatic.jpg|
+|1. On the **Landmarks** tab: \\ 1. Select the **Functional** tab | {{:FunctionalTab.jpg}}|
-====== create functional joint ======
+==== Create Right Functional Joint ====
-|1. on the **landmarks** tab:\\ \\ 1. select the **functional** tab  |  functionaltab.jpg|
+|1. On the **Landmarks** tab: \\ 1. Select the **Functional** tab \\ 2. From the **Functional Joint Name** box, select //F_RKNEE.// \\ 3. Click **Create.** | {{:Create_F_RKNEE.jpg}}|
-===== create right functional joint =====
+|2. **Select tracking targets for the F_RKNEE:** \\ **Tracking Segment/Targets** \\ Select **Use Tracking Targets** (ctrl-click to multi select) \\ //RTHI1//, //RTHI2//, //RTHI3//, //RTHI4// \\ **Other Segment/Targets:** \\ Select **Use Other Targets** (ctrl-click to multi select) \\ //RTIB1//, //RTIB2//, //RTIB3//, //RTIB4// Click on **Close Tab** before proceeding. | {{:Define_F_RKNEE.jpg}}|
-|1. on the **landmarks** tab:\\ \\ 1. select the **functional** tab\\ \\ 2. from the **functional joint name** box, select //f_rknee.//\\ \\ 3. click **create.**  |  create_f_rknee.jpg|
+==== Create Left Functional Joint ====
-|2. **select tracking targets for the f_rknee:**\\ \\ |   **tracking segment/targets**\\    select **use tracking targets** (ctrl-click to multi select)\\      //rthi1//, //rthi2//, //rthi3//, //rthi4//\\ \\ \\    **other segment/targets:**\\    select **use other targets** (ctrl-click to multi select)\\      //rtib1//, //rtib2//, //rtib3//, //rtib4//\\ ||\\ \\ click on **close tab** before proceeding.  |  define_f_rknee.jpg|
+|1. On the **Landmarks** tab: \\ 1. Select the **Functional** tab \\ 2. From the **Functional Joint Name** box, select //F_LKNEE.// \\ 3. Click **Create.** | {{:Create_F_LKNEE.jpg}}|
-===== create left functional joint =====
+|2. **Select tracking targets for the F_LKNEE:** \\ **Tracking Segment/Targets** \\ Select **Use Tracking Targets** (ctrl-click to multi select) \\ //LTHI1//, //LTHI2//, //LTHI3//, //LTHI4// \\ **Other Segment/Targets:** \\ Select **Use Other Targets** (ctrl-click to multi select) \\ //LTIB1//, //LTIB2//, //LTIB3//, //LTIB4// \\ Click on **Close Tab** before proceeding. | {{:Define_F_LKNEE.jpg}}|
-|1. on the **landmarks** tab:\\ \\ 1. select the **functional** tab\\ \\ 2. from the **functional joint name** box, select //f_lknee.//\\ \\ 3. click **create.**  |  create_f_lknee.jpg|
+===== Model Builder Advanced Post Processing =====
-|2. **select tracking targets for the f_lknee:**\\ \\ |   **tracking segment/targets**\\    select **use tracking targets** (ctrl-click to multi select)\\      //lthi1//, //lthi2//, //lthi3//, //lthi4//\\ \\ \\    **other segment/targets:**\\    select **use other targets** (ctrl-click to multi select)\\      //ltib1//, //ltib2//, //ltib3//, //ltib4//\\ ||\\ \\ click on **close tab** before proceeding.  |  define_f_lknee.jpg|
+|1. Select the **Post Processing** button from the menu (image below) \\ {{:ModelBuilderAdvancedPostProcessing_Button.jpg}} \\ 2. Select the **Functional Joints** tab from the dialog box (image on right) \\ |  {{:MBAPP_F_KNEE.jpg}}|
-====== model builder advanced post processing ======
+|3. **Open functional movement file:** \\ 1. Select the **Add Motion File From Disk** \\ 2. **Browse** to functional movement file, select //Functional Knee.c3d// \\ 3. Click **Open** \\ 4. **Select** the motion file by clicking on the trial, this will highlight the trial in **blue**. \\ | {{:MBAPP_SelectMotionFile_KNEE.jpg}}|
-|1. select the **post processing** button from the menu (image below)\\ \\ modelbuilderadvancedpostprocessing_button.jpg\\ \\ 2. select the **functional joints** tab from the dialog box (image on right)\\   |  mbapp_f_knee.jpg|
+**NOTE:** Once the trial has been selected, the name of the trial will be highlighted and the movement file will appear in 3D viewer.
-|3. **open functional movement file:**\\ \\ 1. select the **add motion file from disk**\\ \\ 2. **browse** to functional movement file, select //functional knee.c3d//\\ \\ 3. click **open**\\ \\ 4. **select** the motion file by clicking on the trial, this will highlight the trial in **blue**.\\ \\ \\   |  mbapp_selectmotionfile_knee.jpg|
+==== Define F_RKNEE Start and End of motion ====
-\\
+|1. Select the **START** frame of the right functional movement \\ 1. **Select F_RKNEE**, this will highlight the joint in **blue** \\ 2. Using the **slider** (seen below), select the START frame of the right functional movement. //Set the Start Frame to 241// \\ {{:MBAPP_F_RKNEE_START_slider.jpg}} \\ 3. Click **Set START Event to Current Frame** \\ | {{:MBAPP_F_RKNEE_START.jpg}}|
-**note:** once the trial has been selected, the name of the trial will be highlighted and the movement file will appear in 3d viewer.\\
-\\
+|2. Select the **END** frame of the right functional movement \\ 1. **Select F_RKNEE**, this will highlight the joint in **blue** \\ 2. Using the **slider** (seen below), select the END frame of the right functional movement. //Set the End Frame to 631// \\ {{:MBAPP_F_RKNEE_END_slider.jpg}} \\ 3. Click **Set END Event to Current Frame** \\ | {{:MBAPP_F_RKNEE_END.jpg}}|
-===== define f_rknee start and end of motion =====
+==== Define F_LKNEE Start and End of motion ====
-|1. select the **start** frame of the right functional movement\\ \\ 1. **select f_rknee**, this will highlight the joint in **blue**\\ \\ 2. using the **slider** (seen below), select the start frame of the right functional movement. //set the start frame to 241//\\ \\ mbapp_f_rknee_start_slider.jpg\\ \\ \\ 3. click **set start event to current frame**\\ \\ \\   |  mbapp_f_rknee_start.jpg|
+|1. Select the **START** frame of the left functional movement \\ 1. **Select F_LKNEE**, this will highlight the joint in **blue** \\ 2. Using the **slider**, select the START frame of the left functional movement. //Set the Start Frame to 733// \\ 3. Click **Set START Event to Current Frame** \\ | {{:MBAPP_F_LKNEE_START.jpg}}|
-\\
+|2. Select the **END** frame of the left functional movement \\ 1. **Select F_LKNEE**, this will highlight the joint in **blue** \\ 2. Using the **slider**, select the END frame of the left functional movement. //Set the End Frame to 1149// \\ 3. Click **Set END Event to Current Frame** \\ | {{:MBAPP_F_LKNEE_END.jpg}}|
+===== Compute Landmarks =====
-|2. select the **end** frame of the right functional movement\\ \\ 1. **select f_rknee**, this will highlight the joint in **blue**\\ \\ 2. using the **slider** (seen below), select the end frame of the right functional movement. //set the end frame to 631//\\ \\ mbapp_f_rknee_end_slider.jpg\\ \\ \\ 3. click **set end event to current frame**\\ \\ \\   |  mbapp_f_rknee_end.jpg|
+|1. Select **Compute ALL Landmarks** \\ 2. **Close** the Model Builder Advanced Post Processing dialog box \\ 3. Four landmarks (**F_RKNEE, F_RKNEE_X, F_LKNEE and F_LKNEE_X**) should appear in purple in the 3D viewer \\ **If the landmarks do NOT appear in the 3D viewer, check:** \\ - That the landmarks are turned on (3D View Options) \\ - Check that all steps in this tutorial were completed \\   |  {{:F_RKNEE_F_LKNEE.jpg}}|
-===== define f_lknee start and end of motion =====
+===== Compute Right Mediolateral Borders of the Knee Joint Center =====
-|1. select the **start** frame of the left functional movement\\ \\ 1. **select f_lknee**, this will highlight the joint in **blue**\\ \\ 2. using the **slider**, select the start frame of the left functional movement. //set the start frame to 733//\\ \\ 3. click **set start event to current frame**\\ \\ \\   |  mbapp_f_lknee_start.jpg|
+The RKneLat and RKneMed landmarks created below will be used to define the mediolateral borders of the knee joint.
-|2. select the **end** frame of the left functional movement\\ \\ 1. **select f_lknee**, this will highlight the joint in **blue**\\ \\ 2. using the **slider**, select the end frame of the left functional movement. //set the end frame to 1149//\\ \\ 3. click **set end event to current frame**\\ \\ \\   |  mbapp_f_lknee_end.jpg|
+These landmarks will project the mediolateral targets (RLATKNE,RMEDKNE) onto the axis of rotation created by the functional joint (F_RKNEE,F_RKNEE_X).
-====== compute landmarks ======
-|1. select **compute all landmarks**\\ 2. **close** the model builder advanced post processing dialog box\\ 3. four landmarks (**f_rknee, f_rknee_x, f_lknee and f_lknee_x**) should appear in purple in the 3d viewer\\ \\ \\ **if the landmarks do not appear in the 3d viewer, check:**\\ - that the landmarks are turned on (3d view options)\\ - check that all steps in this tutorial were completed\\   |  f_rknee_f_lknee.jpg|
+|**1. Create Lateral Border of the Right Knee Joint Center (RKneLat):** \\ Click **Landmarks** button \\ Click **Add New Landmark** button \\ Create Landmark: //RKneLat// \\ **Landmark Name:** //RKneLat// \\ **Define Orientation Using:** \\ **Starting Point:** //F_RKNEE// \\ **Ending Point:** //F_RKNEE_X// \\ **Project From:** //RLATKNE// \\ **Do NOT Check:** //Offset by Percent (1.0 = 100%)// \\ //Calibration Only Landmark// | {{:RKneLat.jpg}}|
-====== compute right mediolateral borders of the knee joint center ======
+|**2. Create Medial Border of the Right Knee Joint Center (RKneMed):** \\ Click **Landmarks** button \\ **Add New Landmark** button \\ Create Landmark: \\ **Landmark Name:** //RKneMed// \\ **Define Orientation Using:** \\ **Starting Point:** //F_RKNEE// \\ **Ending Point:** //F_RKNEE_X// \\ **Project From:** //RMEDKNE// \\ **Do NOT Check:** //Offset by Percent (1.0 = 100%)// \\ **Do NOT Check:** //Calibration Only Landmark// | {{:RKneMed.jpg}}|
-the rknelat and rknemed landmarks created below will be used to define the mediolateral borders of the knee joint.
+===== Compute Left Mediolateral Borders of the Knee Joint Center =====
-these landmarks will project the mediolateral targets (rlatkne,rmedkne) onto the axis of rotation created by the functional joint (f_rknee,f_rknee_x).
+The LKneLat and LKneMed landmarks created below will be used to define the mediolateral borders of the knee joint.
-\\
+These landmarks will project the mediolateral targets (LLATKNE,LMEDKNE) onto the axis of rotation created by the functional joint (F_LKNEE,F_LKNEE_X).
+|**1. Create Lateral Border of the Left Knee Joint Center (LKneLat):** \\ Click **Landmarks** button \\ Click **Add New Landmark** button \\ Create Landmark: //LKneLat// \\ **Landmark Name:** //LKneLat// \\ **Define Orientation Using:** \\ **Starting Point:** //F_LKNEE// \\ **Ending Point:** //F_LKNEE_X// \\ **Project From:** //LLATKNE// \\ **Do NOT Check:** //Offset by Percent (1.0 = 100%)// \\ **Do NOT Check:** //Calibration Only Landmark// |{{:LKneLat.jpg}}|
-|**1. create lateral border of the right knee joint center (rknelat):**\\ \\ <html><ol></html>\\ <html><li></html>click **landmarks** button<html></li></html>\\ <html><li></html>click **add new landmark** button<html></li></html>\\ <html><li></html>create landmark: //rknelat//\\ \\ |<html><p></html>   **landmark name:** //rknelat//\\ <html></p></html>\\ \\ <html><p></html>   **define orientation using:**\\    **starting point:** //f_rknee//\\    **ending point:** //f_rknee_x//\\ <html></p></html>\\ \\ <html><p></html>   **project from:** //rlatkne//\\ <html></p></html>||<html></li></html>\\ <html><li></html>**do not check:** //offset by percent (1.0 = 100%)//<html></li></html>\\ <html><li></html>**do not check:** //calibration only landmark//<html></li></html><html></ol></html>  |  rknelat.jpg|
+|**2. Create Medial Border of the Left Knee Joint Center (LKneMed):** \\ Click **Landmarks** button \\ Click **Add New Landmark** button \\ Create Landmark: //LKneMed// \\ **Landmark Name:** //LKneMed// \\ **Define Orientation Using:** \\ **Starting Point:** //F_LKNEE// \\ **Ending Point:** //F_LKNEE_X// \\ **Project From:** //LMEDKNE// \\ **Do NOT Check:** //Offset by Percent (1.0 = 100%)// \\ **Do NOT Check:** //Calibration Only Landmark// | {{:LKneMed.jpg}}|
-\\
-\\
-|**2. create medial border of the right knee joint center (rknemed):**\\ \\ <html><ol></html>\\ <html><li></html>click **landmarks** button<html></li></html>\\ <html><li></html>click **add new landmark** button<html></li></html>\\ <html><li></html>create landmark: //rknemed//\\ \\ |<html><p></html>   **landmark name:** //rknemed//\\ <html></p></html>\\ \\ <html><p></html>   **define orientation using:**\\    **starting point:** //f_rknee//\\    **ending point:** //f_rknee_x//\\ <html></p></html>\\ \\ <html><p></html>   **project from:** //rmedkne//\\ <html></p></html>||<html></li></html>\\ <html><li></html>**do not check:** //offset by percent (1.0 = 100%)//<html></li></html>\\ <html><li></html>**do not check:** //calibration only landmark//<html></li></html><html></ol></html>  |  rknemed.jpg|
-====== compute left mediolateral borders of the knee joint center ======
-the lknelat and lknemed landmarks created below will be used to define the mediolateral borders of the knee joint.
-these landmarks will project the mediolateral targets (llatkne,lmedkne) onto the axis of rotation created by the functional joint (f_lknee,f_lknee_x).
-\\
-|**1. create lateral border of the left knee joint center (lknelat):**\\ \\ <html><ol></html>\\ <html><li></html>click **landmarks** button<html></li></html>\\ <html><li></html>click **add new landmark** button<html></li></html>\\ <html><li></html>create landmark: //lknelat//\\ \\ |<html><p></html>   **landmark name:** //lknelat//\\ <html></p></html>\\ \\ <html><p></html>   **define orientation using:**\\    **starting point:** //f_lknee//\\    **ending point:** //f_lknee_x//\\ <html></p></html>\\ \\ <html><p></html>   **project from:** //llatkne//\\ <html></p></html>||<html></li></html>\\ <html><li></html>**do not check:** //offset by percent (1.0 = 100%)//<html></li></html>\\ <html><li></html>**do not check:** //calibration only landmark//<html></li></html><html></ol></html>  |  lknelat.jpg|
-\\
-\\
-|**2. create medial border of the left knee joint center (lknemed):**\\ \\ <html><ol></html>\\ <html><li></html>click **landmarks** button<html></li></html>\\ <html><li></html>click **add new landmark** button<html></li></html>\\ <html><li></html>create landmark: //lknemed//\\ \\ |<html><p></html>   **landmark name:** //lknemed//\\ <html></p></html>\\ \\ <html><p></html>   **define orientation using:**\\    **starting point:** //f_lknee//\\    **ending point:** //f_lknee_x//\\ <html></p></html>\\ \\ <html><p></html>   **project from:** //lmedkne//\\ <html></p></html>||<html></li></html>\\ <html><li></html>**do not check:** //offset by percent (1.0 = 100%)//<html></li></html>\\ <html><li></html>**do not check:** //calibration only landmark//<html></li></html><html></ol></html>  |  lknemed.jpg|
-}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}