Differences

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

--- visual3d:tutorials:modeling:correcting_mislabeled_markers [2024/07/12 14:09] – created sgranger
+++ visual3d:tutorials:modeling:correcting_mislabeled_markers [2024/11/29 16:18] (current) – Added separate Data Files section. wikisysop
@@ Line 1: / Line 1: @@
-====== Correcting_Mislabeled_Markers ======
+===== Correcting Mislabeled Markers =====
-==== Introduction ====
+It sometimes happens that mistakes are made in the labeling of your markers, either through operator error of the motion capture system's difficulty recognizing markers throughout a trial. These mistakes must be fixed in order to ensure high quality data. This is the first step towards producing useful follow-on analysis.
-If you mistakes have been made in the labeling of your markers then these mistakes need to be fixed in order to ensure high quality data. This tutorial explains how to do this, using the specific example of the **RTH1** marker labelled as **RTH2** and vice versa. The rest of this tutorial will show you how to effectively fix this.
+Our recommendation is that mistakes like these should be corrected as close to the actual data collection as possible. Ideally you will do this in the motion capture software provided by your vendor of choice, as this gives you the best chance to recognize mistakes and to apply the correct fix. If that is not possible, or anything is missed during data collection, then you can fix these mistakes in Visual3D. This tutorial explains how to do exactly this, using the specific example where the **RTH1** and **RTH2** markers have had their labels switched, i.e., the **RTH1** marker is labelled as **RTH2** and vice versa.
 **Note:** There is also a video tutorial available [[https://www.youtube.com/watch?v=c_WkIvKTF5o%7C|here]]
-==== Fixing the Mislabeled Markers ====
+==== Data Files ====
-**1.** The first step is to expand the //TARGET// menu by clicking on the + sign next to it.
+As this is a reasonably straight forward process in Visual3D, no example files are provided for you to work through. This process can be tested on any of your files containing marker-based data, for example by purposefully mislabelling two [[visual3d:documentation:c3d_signal_types:target_data_type|TARGETs]] and then fixing them.
-{{TargetExpandHighlight.png}}
+==== Fixing Mislabeled Markers ====
-**2.** Next expand the //ORIGINAL// menu by clicking the + sign next to it.
+**1.** Expand the TARGET data type in the Signals and Events tab's [[visual3d:documentation:visual3d_signal_types:data_tree|Data Tree]] by clicking on the + sign next to it.
-{{OriginalExpandHighlight.png}}
+{{:TargetExpandHighlight.png}}
-**3.** In the //ORIGINAL// list find the first of the mislabeled markers (in this case **RTH1**) and right click on it. Then select //Rename Label//
+**2.** Next expand the TARGET data type's [[visual3d:documentation:visual3d_signal_types:data_tree#original_and_processed_data|ORIGINAL folder]] by clicking the + sign next to it.
-{{RenameLabelHighlight.png}}
+{{:OriginalExpandHighlight.png}}
-**4.** When the //Rename Label// window is open you need to input the correct label but because **RTH2** is still in use you can't change it to that right away so you need to use an interim label until you can properly change it; in this example we used **RTH2a**
+**3.** In the ORIGINAL folder's list of signals, find the first of the mislabeled markers, in this case **RTH1**, and right click on it. Then select //Rename Label//.
-{{MarkerRelabelTemp.png}}
+{{:RenameLabelHighlight.png}}
-**5.** Close the //Rename Label// window. **6.** Right click on **RTH2**, open the //Rename Label// window and then rename it **RTH1**.
+**4.** The //Rename Label// window prompts you to input the correct label but because **RTH2** is still in use you can't change it to that right away. Instead, use an interim label until you can properly change it; in this example we used **RTH2a**.
-{{RelabelRTH1.png}}
+{{:MarkerRelabelTemp.png}}
-**7.** Now that the label **RTH2** is no longer being used you can go back and replace temporary label of **RTH2a** with the correct label **RTH2**.
+**5.** Close the //Rename Label// window.
-{{RelabelRTH2.png}}
+**6.** In the ORIGINAL folder's list of signals, find the second mislabeled marker, in this case **RTH2**. Right click on it to open the //Rename Label// window and then rename it **RTH1**.
-**8.** The markers are now correctly labeled, the final step is to make sure the correction is completed by clicking the //Recalc// button.
+{{:RelabelRTH1.png}}
-{{RecalcButtonHighlight.png}}
+**7.** Now that the label **RTH2** is no longer being used you can go back and replace interim label of **RTH2a** with the correct label **RTH2**.
+{{:RelabelRTH2.png}}
+==== Running Recalc ====
+**8.** The markers are now correctly labeled, the final step is to make sure the correction is completed by clicking the [[visual3d:documentation:pipeline:general_information:recalc_pipeline|Recalc]] button. This is a very important step, as without it the changes you have made will not be reflected in your analysis.
+{{:RecalcButtonHighlight.png}}