Differences

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

--- visual3d:tutorials:modeling:digitizing_pointer_post_processing [2024/06/19 12:54] – sgranger
+++ visual3d:tutorials:modeling:digitizing_pointer_post_processing [2024/07/17 15:46] (current) – created sgranger
@@ Line 1: / Line 1: @@
-{{{{{{{{{{{{{{{{{{{{{{the objective for using a digitizing pointer is to identify anatomical landmarks without having to place motion capture markers at the location. for background information see [[visual3d:documentation:modeling:landmarks:digitizing_pointer|here]].
+====== Digitizing Pointer Post Processing ======
-**note that this functionality is not available in visual3d lite. we have not sold a copy of visual3d lite for many many years, so hopefully this won't adversely affect too many laboratories.**
+The objective for using a digitizing pointer is to identify anatomical landmarks without having to place motion capture markers at the location. For background information see [[Visual3D:Documentation:Modeling:Landmarks:Digitizing_Pointer|here]].
+**Note that this functionality is not available in Visual3D Lite. We have not sold a copy of Visual3D Lite for many many years, so hopefully this won't adversely affect too many laboratories.**
 \\
-download the [[https://www.has-motion.com/download/examples/pointer.zip|example files]] to be used in this tutorial.
+Download the [[https://www.has-motion.com/download/examples/pointer.zip|example files]] to be used in this tutorial.
-==== data collection ====
+=== Data Collection ===
-**the first step in the process is to capture a standing trial. note that the pointer must be in the scene, so that we can create a model for the pointer.**
+**The first step in the process is to capture a standing trial. Note that the pointer must be in the scene, so that we can create a model for the pointer.**
-**before the files are brought into visual3d, two c3d trials must be collected:**
+**Before the files are brought into Visual3D, two C3D trials must be collected:**
-  - **the static trial.** during this trial -
+  - **The Static trial.** During this trial -
-    - the subject must be stationary
+    - The subject must be stationary
-    - the subject must be markered up
+    - The subject must be markered up
-    - the pointer must appear in the trial
+    - The pointer must appear in the trial
-  - **the pointer trial.** during this trial -
+  - **The Pointer trial.** During this trial -
-    - the subject should be relatively stationary
+    - The subject should be relatively stationary
-    - the pointer should be moved around the volume and the tip of the pointer placed on the landmarks which the user would like to identify
+    - The pointer should be moved around the volume and the tip of the pointer placed on the landmarks which the user would like to identify
-    - if a spring loaded pointer is used, the wand should be compressed when the tip is on the landmark which the user would like to identify. visual3d will automatically identify when the pointer is compressed
+    - If a spring loaded pointer is used, the wand should be compressed when the tip is on the landmark which the user would like to identify. Visual3D will automatically identify when the pointer is compressed
-    - the pointer can be used to identify one landmark or multiple landmarks within a trial
+    - The pointer can be used to identify one landmark or multiple landmarks within a trial
-**note:** the target ids should be consistent between the static and pointer trial
+**NOTE:** The target IDs should be consistent between the static and pointer trial
-==== step 1. create a model ====
+=== Step 1. Create a model ===
-|**1. load static c3d file**\\ \\ - create a hybrid model using **static.c3d.**  |  createhybridmodelmenu.jpg|
+|**1. Load Static C3D file**\\ \\ - Create a hybrid model using **Static.c3d.**  |  {{:CreateHybridModelMenu.jpg}}|
-|\\ \\ the digitized landmarks will be created in the static trial.\\ \\ the 3d viewer should show a unilateral marker set with only tracking markers and the two markers on the pointer collected. in this file the pointer markers are labelled //p.prox// and //p.dist//\\ \\ **note:** the pointer **must** be in the scene, so that we can create a model for the pointer.\\ \\ \\   |  standingwithpointer.jpg|
+|\\ \\ The digitized landmarks will be created in the static trial.\\ \\ The 3D viewer should show a unilateral marker set with only tracking markers and the two markers on the pointer collected. In this file the pointer markers are labelled //P.PROX// and //P.DIST//\\ \\ **Note:** The pointer **MUST** be in the scene, so that we can create a model for the pointer.\\ \\ \\   |  {{:StandingWithPointer.jpg}}|
-==== step 2. define landmarks ====
+=== Step 2. Define Landmarks ===
-|**1. go to the digitizing landmark**\\ \\ - select the model builder tab\\ - select the landmarks property page\\ - select the digitizing tab  |  creatertoelandmarkstep1.jpg|
+|**1. Go to the digitizing landmark**\\ \\ - Select the Model Builder tab\\ - Select the Landmarks Property page\\ - Select the Digitizing Tab  |  {{:CreateRTOElandmarkStep1.jpg}}|
-|\\ **2. define digitizing landmarks**\\ \\ - under digitizing point name type //d_rtoe_medial//\\ - click **create**\\ \\ **note:** digitizing points may be explicitly defined by typing directly into the combo box, or user's can select from the list of default default digitizing landmark definitions. the naming convention for the default digitizing landmark definitions is as follows: d_rhip_lateral refers to a **d**igitizing landmark for the **r**ight **hip lateral** surface  |  creatertoelandmark.jpg|
+|\\ **2. Define digitizing landmarks**\\ \\ - Under Digitizing Point Name type //D_RTOE_MEDIAL//\\ - Click **Create**\\ \\ **NOTE:** Digitizing points may be explicitly defined by typing directly into the combo box, or user's can select from the list of default default digitizing landmark definitions. The naming convention for the default digitizing landmark definitions is as follows: D_RHIP_LATERAL refers to a **D**igitizing landmark for the **R**ight **Hip Lateral** Surface  |  {{:CreateRTOElandmark.jpg}}|
-|**3. in the list box that appears select the 3 tracking markers associated with this landmark.**\\ \\ **4. click close tab**  |  rtoelandmarktracking.jpg|
+|**3. In the list box that appears select the 3 tracking markers associated with this landmark.**\\ \\ **4. Click Close Tab**  |  {{:RTOELandmarkTracking.jpg}}|
-**5. continue to add the following landmarks to the listbox:**
+**5. Continue to add the following landmarks to the listbox:**
-d_rtoe_lateral
+D_RTOE_LATERAL
-d_rankle_lateral
+D_RANKLE_LATERAL
-d_rankle_medial
+D_RANKLE_MEDIAL
-d_rknee_medial
+D_RKNEE_MEDIAL
-d_rknee_lateral
+D_RKNEE_LATERAL
-d_rasis
+D_RASIS
-d_rilcr
+D_RILCR
-d_rtroch
+D_RTROCH
-d_lasis
+D_LASIS
-d_licr
+D_LICR
-d_lpsis
+D_LPSIS
-d_ltroch
+D_LTROCH
-the tracking targets selected should not move relative to the "landmark" between the digitizing point trial and the static calibration trial. you can also load the previously defined digitizing landmarks to see an example. the instructions to do this are listed below (both a mdh and vpn file are included in the sample data files).
+The tracking targets selected should not move relative to the "landmark" between the digitizing point trial and the static calibration trial. You can also load the previously defined digitizing landmarks to see an example. The instructions to do this are listed below (both a mdh and vpn file are included in the sample data files).
-**to load previously defined digitizing landmarks:**
+**To load previously defined digitizing landmarks:**
-if you already have a **model template (mdh)** with digitizing landmarks created, you can select model -> apply model template.
+If you already have a **model template (mdh)** with digitizing landmarks created, you can select Model -> Apply Model Template.
-this will load data from a mdh file. this is the recommended method to save the definition of digitizing landmarks
+This will load data from a MDH file. This is the recommended method to save the definition of digitizing landmarks
-if you already have a **landmarks template file (vpn)**, you can select **load points from file.**
+If you already have a **landmarks template file (vpn)**, you can select **Load Points From File.**
-this will load data from a vpn file. this is a legacy feature and it is recommended to save this information in the model template.
+This will load data from a VPN file. This is a legacy feature and it is recommended to save this information in the model template.
-**note:** please note that if you are using a spring loaded pointer, **the order in which you define the digitizing points**, should reflect the order in which you will point to the landmarks in the digitizing trial
+**NOTE:** Please note that if you are using a spring loaded pointer, **the order in which you define the digitizing points**, should reflect the order in which you will point to the landmarks in the digitizing trial
-==== step3.create the digitizing wand ====
+=== Step3.Create the digitizing wand ===
-if you have already created the digitizing wand, this step may not be necessary. it doesn't, however, hurt to check the properties.
+If you have already created the digitizing wand, this step may not be necessary. It doesn't, however, hurt to check the properties.
-|**1. define the wand:**\\ \\ - select **create/modify digitizing wand** from the digitizing landmark tab\\ - the landmark will be created relative to the markers labelled **p.dist** and **p.prox**. these same two markers will move when the spring is compressed (this pointer trial was created using our original 2 marker pointer).\\ - select **ok**  |  digitizingpointerconfiguration.jpg|
+|**1. Define the wand:**\\ \\ - Select **Create/Modify Digitizing Wand** from the Digitizing Landmark tab\\ - The landmark will be created relative to the markers labelled **P.DIST** and **P.PROX**. These same two markers will move when the spring is compressed (this pointer trial was created using our original 2 marker pointer).\\ - Select **OK**  |  {{:DigitizingPointerConfiguration.jpg}}|
 \\
-|**2. view the pointer in the 3d viewer:**\\ \\ a. select **build model** and a landmark should be created relative to these two markers. this landmark represents the tip of the pointer.  |  pointerlandmark.jpg|
+|**2. View the pointer in the 3D viewer:**\\ \\ A. Select **Build Model** and a landmark should be created relative to these two markers. This landmark represents the tip of the pointer.  |  {{:PointerLandmark.jpg}}|
-==== step 4. select the model builder post process icon on the toolbar ====
+=== Step 4. Select the Model Builder Post Process icon on the Toolbar ===
-|**1. open the post processing dialog**  |  modelbuilderpostprocessicon.jpg|
+|**1. Open the Post processing dialog**  |  {{:ModelBuilderPostProcessIcon.jpg}}|
 \\
-|**2. in the post processing dialog:**\\ \\ 1. select the **digitize landmarks** tab\\ \\ 2. select **add a pointer motion file from disk** and add the motion file **motion.c3d** (e.g. the file in which the pointer is moved around in the scene to identify the landmarks)  |  modelbuilderpostprocessingtab.jpg|
+|**2. In the post processing dialog:**\\ \\ 1. Select the **Digitize Landmarks** tab\\ \\ 2. Select **Add a Pointer Motion File From Disk** and add the motion file **Motion.c3d** (e.g. the file in which the pointer is moved around in the scene to identify the landmarks)  |  {{:ModelBuilderPostProcessingTab.jpg}}|
 \\
-**3. define the time in the trial when the pointer is identifying a landmark:**
+**3. Define the time in the trial when the pointer is identifying a landmark:**
+There are two ways that you can define the frame at which to capture the tip location:
-there are two ways that you can define the frame at which to capture the tip location:
+Option 1:
-option 1:
+You can play the motion trial and stop the trial at the frame of data that you want. Select the **Add Event at Current Frame** button.\\
-you can play the motion trial and stop the trial at the frame of data that you want. select the **add event at current frame** button.\\
+|Option 2:\\ \\ 1. You can select Scan for **Spring Pointer Events**, which causes Visual3D to look for frames in which the spring is being compressed in the motion trial.\\ \\ 2. Select **Compute ALL Landmarks** will create the landmarks in the static trial.\\ \\ \\   |  {{:PostProcessingTabPopulated.jpg}}|
-|option 2:\\ \\ 1. you can select scan for **spring pointer events**, which causes visual3d to look for frames in which the spring is being compressed in the motion trial.\\ \\ 2. select **compute all landmarks** will create the landmarks in the static trial.\\ \\ \\   |  postprocessingtabpopulated.jpg|
+|In order to see the landmarks you will need to close the Post Processing Modeling Tab, so that Visual3D makes the standing trial active in Model Builder Mode.\\ \\ These landmarks are now part of the model. If the model template is saved, these landmarks (and their definitions) will be saved in the model template file.\\ \\ These landmarks can be used to define the segments.  |  {{:DigitizedPoints.jpg}}|
-|in order to see the landmarks you will need to close the post processing modeling tab, so that visual3d makes the standing trial active in model builder mode.\\ \\ these landmarks are now part of the model. if the model template is saved, these landmarks (and their definitions) will be saved in the model template file.\\ \\ these landmarks can be used to define the segments.  |  digitizedpoints.jpg|
+**NOTE:** It's also possible to use the digitizing pointer in Real Time streaming mode, however, it's recommended to use the post processing to ensure you still have the data. An example of using the [[Visual3D:Documentation:Modeling:Landmarks:Digitizing_Pointer_from_Streaming_Data|digitizing pointer from streaming data can be found here]].
-**note:** it's also possible to use the digitizing pointer in real time streaming mode, however, it's recommended to use the post processing to ensure you still have the data. an example of using the [[visual3d:documentation:modeling:landmarks:digitizing_pointer_from_streaming_data|digitizing pointer from streaming data can be found here]].
-}}}}}}}}}}}}}}}}}}}}}}