Differences

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

--- visual3d:documentation:modeling:update_dsx_knee_model_template [2024/06/19 12:48] – sgranger
+++ visual3d:documentation:modeling:update_dsx_knee_model_template [2024/07/17 15:45] (current) – created sgranger
@@ Line 1: / Line 1: @@
-{{{{{{{{{{{{{{{{{{{{{{this page walks you through modifying the default dsx knee model template (mdh file) in visual3d for use with different target labels.
+====== Update DSX Knee Model Template ======
-===== load files =====
+This page walks you through modifying the default DSX Knee Model Template (MDH file) in Visual3D for use with different target labels.
-|**1. open visual3d**  |  |
+==== Load Files ====
-|**2. load static c3d file**\\ \\ model→\\ \\ create (add static calibration file)→\\ \\ hybrid model from c3dfile→\\ \\ select a static trial collected in your lab  |  dsx_kneemdh_loadstaticc3d.png|
+|**1. Open Visual3D**  |  |
-|**3. load dsx model template (.mdh file)**\\ \\ model→\\ \\ apply model template→\\ \\ browse to the dsx model template on your computer\\ \\ note: there will be build errors, that's fine  |  dsx_kneemdh_applymodeltemplate.png|
+|**2. Load Static C3D file**\\ \\ Model→\\ \\ Create (Add Static Calibration File)→\\ \\ Hybrid Model from C3DFile→\\ \\ Select a static trial collected in your lab  |  {{:DSX_KneeMDH_LoadStaticC3D.png}}|
-===== update segment definition =====
+|**3. Load DSX Model Template (.mdh file)**\\ \\ Model→\\ \\ Apply Model Template→\\ \\ Browse to the DSX model template on your computer\\ \\ Note: There will be build errors, that's fine  |  {{:DSX_KneeMDH_ApplyModelTemplate.png}}|
-|**1. in the models tab, under the segments button, in the segments tab, there is a list of segments. these segments must be updated to reflect the new tracking target labels.**\\ \\ to update each segment, double click on the desired segment name.  |  dsx_kneemdh_segmentlist.png|
+==== Update Segment Definition ====
-|**a. update pelvis definition**\\ \\ select target labels from the drop down list which represent the asis/psis labels. if only using a sacrum label, enter the sacrum label into both the left and right sacrum boxes.\\ \\ if using other tracking targets (ex. iliac crest) specify them here.  |  dsx_kneemdh_pelvisdef.png|
+|**1. In the Models tab, under the Segments button, in the Segments tab, there is a list of segments. These segments must be updated to reflect the new tracking target labels.**\\ \\ To update each segment, double click on the desired segment name.  |  {{:DSX_KneeMDH_SegmentList.png}}|
-|**b. update thigh definition**\\ \\ the left_hip and right_hip landmarks are created from the pelvis, so do not modify these.\\ \\ in the **distal joint and radius** section, specify the lateral and medial epicondyle knee targets.\\ \\ in the tracking targets section, click on the tracking targets.\\ \\ note: when selecting tracking targets, you must click in the check box. clicking on the target name will deselect all tracking targets.  |  dsx_kneemdh_thighdef.png|
+|**A. Update Pelvis Definition**\\ \\ Select target labels from the drop down list which represent the ASIS/PSIS labels. If only using a sacrum label, enter the sacrum label into both the left and right sacrum boxes.\\ \\ If using other tracking targets (ex. iliac crest) specify them here.  |  {{:DSX_KneeMDH_PelvisDef.png}}|
-|**c. update shank definition**\\ \\ the l/rkjc is a landmark created from the thigh, so do not modify this.\\ \\ in the **distal joint and radius** section, specify the lateral and medial malleoli ankle targets.\\ \\ in the tracking targets section, click on the tracking targets.\\ \\ note: when selecting tracking targets, you must click in the check box. clicking on the target name will deselect all tracking targets.  |  dsx_kneemdh_shankdef.png|
+|**B. Update Thigh Definition**\\ \\ The LEFT_HIP and RIGHT_HIP landmarks are created from the pelvis, so do not modify these.\\ \\ In the **Distal Joint and Radius** section, specify the lateral and medial epicondyle knee targets.\\ \\ In the Tracking Targets section, click on the tracking targets.\\ \\ Note: When selecting tracking targets, you must click in the check box. Clicking on the target name will deselect all tracking targets.  |  {{:DSX_KneeMDH_ThighDef.png}}|
-note: the l/rpt, femur, tibia and patella segments should not be modified.
+|**C. Update Shank Definition**\\ \\ The L/RKJC is a landmark created from the thigh, so do not modify this.\\ \\ In the **Distal Joint and Radius** section, specify the lateral and medial malleoli ankle targets.\\ \\ In the Tracking Targets section, click on the tracking targets.\\ \\ Note: When selecting tracking targets, you must click in the check box. Clicking on the target name will deselect all tracking targets.  |  {{:DSX_KneeMDH_ShankDef.png}}|
-===== update model metrics =====
-|**1. update the necessary model metrics. in the models tab, under the subject data/metrics button, in the subject data tab, there is a list of model metrics.**\\ \\ to update each segment, double click on the desired segment name.  |  dsx_kneemdh_modelmetrics.png|
+Note: The L/RPT, Femur, Tibia and Patella segments should not be modified.
+==== Update Model Metrics ====
-|**a. update lth_tracking_target_types**\\ \\ this list should be identical to the tracking list selected in the dialog\\ \\ the default is shown below, but it should reflect the tracking list you selected for your marker set\\ \\ 'landmark+target+target+target+target+target+target\\ \\ click "ok"\\ \\ note: the left_hip landmark and llk, lmk, lth1, lth2, lth3, lth4 targets are used to track the thigh. since there is one landmark, and six targets, the list should be landmark + target (listed six times). landmark should always be listed first.  |  dsx_kneemdh_thightargettypes.png|
+|**1. Update the necessary model metrics. In the Models tab, under the Subject Data/Metrics button, in the Subject Data tab, there is a list of model metrics.**\\ \\ To update each segment, double click on the desired segment name.  |  {{:DSX_KneeMDH_ModelMetrics.png}}|
-|**b. update lth_tracking_target_list**\\ \\ this list should be identical to the tracking list selected in the dialog\\ \\ the default is shown below, but it should reflect the tracking list you selected for your marker set\\ \\ 'left_hip+llk+lmk+lth1+lth2+lth3+lth4\\ \\ click "ok"\\ \\ note: the single quote at the start of the line is important, this tells visual3d the value is a string.  |  dsx_kneemdh_thightargetlist.png|
+|**A. Update LTH_TRACKING_TARGET_TYPES**\\ \\ This list should be identical to the tracking list selected in the dialog\\ \\ The default is shown below, but it should reflect the tracking list you selected for your marker set\\ \\ 'LANDMARK+TARGET+TARGET+TARGET+TARGET+TARGET+TARGET\\ \\ Click "OK"\\ \\ Note: The LEFT_HIP landmark and LLK, LMK, LTH1, LTH2, LTH3, LTH4 targets are used to track the thigh. Since there is one landmark, and six targets, the list should be LANDMARK + TARGET (listed six times). Landmark should always be listed first.  |  {{:DSX_KneeMDH_ThighTargetTypes.png}}|
-|**c. update tracking list for right thigh and left/right shank segments**  |  |
+|**B. Update LTH_TRACKING_TARGET_LIST**\\ \\ This list should be identical to the tracking list selected in the dialog\\ \\ The default is shown below, but it should reflect the tracking list you selected for your marker set\\ \\ 'LEFT_HIP+LLK+LMK+LTH1+LTH2+LTH3+LTH4\\ \\ Click "OK"\\ \\ Note: The single quote at the start of the line is important, this tells Visual3D the value is a string.  |  {{:DSX_KneeMDH_ThighTargetList.png}}|
-|**d. update thigh_scale** (if necessary)\\ \\ this value will update automatically for every subject - but if you only have targets on one leg, you should remove the seg_length for the segment you are not using.\\ \\ so if only using left side targets, specify this value as ( lth_seg_length * 0.5 ) / .404\\ \\ note: you do not need quotes or single quotes here  |  dsx_kneemdh_thighscale.png|
+|**C. Update tracking list for right thigh and left/right shank segments**  |  |
-===== save updated model template =====
+|**D. Update THIGH_SCALE** (if necessary)\\ \\ This value will update automatically for every subject - but if you only have targets on ONE leg, you should remove the SEG_LENGTH for the segment you are not using.\\ \\ So if only using left side targets, specify this value as ( LTH_SEG_LENGTH * 0.5 ) / .404\\ \\ Note: You do not need quotes or single quotes here  |  {{:DSX_KneeMDH_ThighScale.png}}|
+==== Save Updated Model Template ====
+|**6. Save Updated Model Template**\\ \\ Model→Save Model Template  |  {{:DSX_KneeMDH_SaveMDH.png}}|
-|**6. save updated model template**\\ \\ model→save model template  |  dsx_kneemdh_savemdh.png|
-}}}}}}}}}}}}}}}}}}}}}}