Differences

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

--- visual3d:tutorials:reports:comparing_data_sets [2024/07/17 15:42] – removed sgranger
+++ visual3d:tutorials:reports:comparing_data_sets [2024/07/17 15:47] (current) – created sgranger
@@ Line 1: / Line 1: @@
+====== Comparing Data Sets ======
+===== Introduction =====
+This tutorial is going to describe comparing different data sets. In this example, we're going to compare data between various subjects.
+=== Download ===
+[[https://www.has-motion.com/download/examples/ComparingDataSets.zip|The sample files can be downloaded here.]]
+  * Data:
+    * Sub 01 CMZ
+    * Sub 02 CMZ
+    * Sub 03 CMZ
+  * Scripts:
+    * Tag.v3s (Example script that can be used to tag the files)
+    * Tag_Loop.v3s (Example script that can be used to tag the files using a For_Each loop)
+    * Overlay.v3s (Example script that can be used to overlay the report template with another subject)
+    * Overlay_Loop.v3s (Example script that can be used to overlay the report template with another subject using a For_Each loop)
+  * Report Templates:
+    * Report_Template_ALL_FILES.rgt
+    * Report_Template_Sub_01.rgt
+===== Prepare the Workspace =====
+The first step is to load the data. It's recommended that you use the CMO Library to view multiple CMZ files at once. Many users simply choose to do a File -> Open if they're viewing two small files. This option works for smaller data sets, but it's really recommended to use the CMO Library instead.
+=== View files using the CMZ Library ===
+  - **CMO Library -> Set CMO Library Path**
+    - Select **..Comparing Data Sets\Data folder**
+    - Click **OK**
+  - **CMO Library -> Browse CMO Library**
+    - Select **Yes**
+[[Visual3D:Documentation:Definitions:CMO_Library_#Load_the_CMO_Library|More detailed instructions to load the CMO Library can be found here]].
+===== Tag Files =====
+|**Once the data is loaded in the workspace, create three tags:**\\ \\ ****\\ \\ - Sub_01\\ - Sub_02\\ - **Sub_03**  |  {{:CompareDataSets_Tags.png}}  |
+**There are a few ways to create tags:** (Choose one method of the following)
+  - [[Visual3D:Documentation:Definitions:Tag#Creating_Tags:|Manually add tags]] to the files or use the pipeline.
+  - Use the [[Visual3D:Documentation:Pipeline:File_Commands:Assign_Tags_To_File|Assign_Tags_To_File]] command to assign tags to subjects based on the filename. This can be done using the provided **Tag.v3s file**.
+  - Using the [[Visual3D:Documentation:Pipeline:Pipeline_Commands:For_Each_and_End_For_Each|For_Each]] command, you can loop over all the subjects in your workspace to create individual tags for them. This can be done using the provided **Tag_Loop.v3s file**.
+===== Graph Data =====
+Once the data has been loaded and tagged, create a report template that plots the data.
+=== 1. Change Report Template to Plot Sub_01 tag ===
+A. **Open a report template** that plots the signals you are interested in viewing (ex. Open provided **Report_Template_ALL_FILES.rgt**)
+B. Change the tag from ALL_FILES (or whatever you're currently plotting) to one of the tags you want to plot (ex. Sub_01) and set the line color to the same for both the right and left sides.
+a. **Search/Replace**:
+|a1. Old File Tag: **ALL_FILES**\\ \\ a2. New File Tag: **Sub_01**\\ \\ a3. Click **"Add>>"**\\ \\ a4. Old Line Color: **#109900**\\ \\ a5. New Line Color: **Purple**\\ \\ a6. Click **"Add>>"**\\ \\ a7. Old Line Color: **#990000**\\ \\ a8. New Line Color: **Purple**\\ \\ a9. Click **"Add>>"**\\ \\ a10. Select **"Entire Report"**\\ \\ a11. Click **"Replace"**  |  {{:CompareDataSets_SearchReplace.png}}  |
+D. **Save report template** (ex. Report_Template_Sub_01.rgt)
+=== 2. Overlay other subject's data ===
+**The step to overlay the subject data can be done manually (as described below), or using the pipeline** (ex. provided scripts from download Overlay.v3s or Overlay_Loop.v3s).
+A. Overlay Sub_02 on top of Sub_01
+a. **Overlay Report**:
+|a1. Page No: ALL_PAGES\\ \\ a2. Identifier Type: TAG_NAME\\ \\ a3. Identifier Value: Sub_01\\ \\ a4. New Tag: Sub_02\\ \\ a5. New Color: Blue  |  {{:CompareDataSets_Overlay.png}}  |
+B. Overlay Sub_03 on top of Sub_01
+a. **Overlay Report**:
+a1. Page No: **ALL_PAGES**
+a2. Identifier Type: **TAG_NAME**
+a3. Identifier Value: **Sub_01**
+a4. New Tag: **Sub_03**
+a5. New Color: **Cyan**
+C. Display the tag name in the Legend of the report