HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » sift » tutorials » Build Normal Database
sift:tutorials:build_normal_database

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
sift:tutorials:build_normal_database [2024/11/25 19:18] – wikisysopsift:tutorials:build_normal_database [2025/02/27 20:51] (current) – wikisysop
Line 5: Line 5:
 ===== Data ===== ===== Data =====
  
-This tutorial can be completed with any CMZ file. One possibility is a data set from a Visual3D Workshop at a recent ASB meeting: [[https://www.has-motion.com/download/examples/V3D_Workshop.zip|V3D Workshop @ ASB]].\\ +This tutorial can be completed with any CMZ file. This tutorial will be using the data set from a Visual3D Workshop at a recent ASB meeting: [[https://www.has-motion.com/download/examples/V3D_Workshop.zip|V3D Workshop @ ASB]].\\ 
-**Supporting files for this tutorial if using ABS workshop data:**+**Supporting files for this tutorial if using ABS workshop data:** [[https://has-motion.com/download/Tut-buildNDs.zip|download here]]
   * **GPS_GDI_Joint_Angles.v3s** - Visual3D Pipeline Script for GPS and GDI required Joint Angles   * **GPS_GDI_Joint_Angles.v3s** - Visual3D Pipeline Script for GPS and GDI required Joint Angles
   * **BuildND_Queries.q3d** - Sift Query Definition File to query normalized joint angles to be summarized and saved in the Normal Database   * **BuildND_Queries.q3d** - Sift Query Definition File to query normalized joint angles to be summarized and saved in the Normal Database
Line 13: Line 13:
  
 {{ :sift_load_page.png?700}} {{ :sift_load_page.png?700}}
-To start, you need to tell Sift where to look for you data. After opening Sift:+To start, you need to load the data into Sift. After opening Sift:
  
   - Click the {{:sift_library_load.png?20}}**Load Library** on the toolbar or the top left of the [[Sift:Application:Load_Page|load page]]:   - Click the {{:sift_library_load.png?20}}**Load Library** on the toolbar or the top left of the [[Sift:Application:Load_Page|load page]]:
Line 23: Line 23:
     - Verify which CMZ file have been loaded in the 3D Viewer, as well as which C3D files are associated with each CMZ;     - Verify which CMZ file have been loaded in the 3D Viewer, as well as which C3D files are associated with each CMZ;
  
 +----
  
 ===== 2. Run External Script ===== ===== 2. Run External Script =====
  
-In this specific tutorial, we are actually preparing a Normal Database to be used in a [[sift:tutorials:compute_GPS_and_GDI|tutorial]] for the [[Sift:gait_measures:gait_profile_score|Gait Profile Score]] and [[Sift:gait_measures:gait_deviation_index|Gait Deviation Index]] calculations. Therefore, we need to make sure we have the correct joint angles computed in our CMZ workspaces. To do so, we are going to run a Visual3D pipeline script (.v3s file) against the loaded library. \\+In this specific tutorial, we are building a Normal Database to be used in a [[sift:tutorials:compute_GPS_and_GDI|tutorial]] for the [[Sift:gait_measures:gait_profile_score|Gait Profile Score]] and [[Sift:gait_measures:gait_deviation_index|Gait Deviation Index]] calculations. Therefore, we need to make sure we have the correct joint angles computed in our CMZ workspaces. To do so, we are going to run a Visual3D pipeline script (.v3s file) against the loaded library. \\
  
 ==== Pipeline Script ==== ==== Pipeline Script ====
-The pipeline can be found here: \\ 
-**Note**: this pipeline was derived for the sample workspace associated with this tutorial. If running this against your own data, make sure to verify the Link_Model_Based calculations with the GPS definitions to insure you have the correct angles. \\ 
 A sample of this pipeline script can be seen here:\\ A sample of this pipeline script can be seen here:\\
 +**Note**: this pipeline was derived for the sample workspace associated with this tutorial. If running this against your own data, make sure to verify the Link_Model_Based calculations with the GPS definitions to insure you have the correct angles. \\
 +
   !/////////////////////////////////////////////////////////////////////////////////////////////////   !/////////////////////////////////////////////////////////////////////////////////////////////////
   ! Compute LEFT Joint Angles   ! Compute LEFT Joint Angles
Line 90: Line 91:
   - Wait for the CMZs to update and the library to load.\\   - Wait for the CMZs to update and the library to load.\\
  
-{{ sift:tutorials:buildNDQueries.png?500}} + 
-\\ +
-\\+
 ===== 3. Define Queries ===== ===== 3. Define Queries =====
-\\+{{ :sift:tutorials:buildNDQueries.png?850}} 
 + 
 To select which signals from our CMZ workspaces we want to summarize and include in the Normal Database, we first need to query them. These signals will be L or R specific (not grouped sides), and will be normalized to 101 points. For this sample dataset and it's existing events in the CMZ workspaces, all left signals will be normalized to LHS-LHS and right signals will be normalized to RHS-RHS.\\ To select which signals from our CMZ workspaces we want to summarize and include in the Normal Database, we first need to query them. These signals will be L or R specific (not grouped sides), and will be normalized to 101 points. For this sample dataset and it's existing events in the CMZ workspaces, all left signals will be normalized to LHS-LHS and right signals will be normalized to RHS-RHS.\\
  
Line 103: Line 105:
   - Exit the [[sift:application:query_builder_dialog|Query Builder Dialog]] \\   - Exit the [[sift:application:query_builder_dialog|Query Builder Dialog]] \\
  
- +----
-\\ +
-\\ +
-\\ +
 ===== 4. Build Normal Database ===== ===== 4. Build Normal Database =====
  
 Now that we have queried the signals, we can see our [[sift:application:groups_and_workspaces|groups and workspaces]] on the [[sift:application:Explore_Page|Explore Page]].\\ Now that we have queried the signals, we can see our [[sift:application:groups_and_workspaces|groups and workspaces]] on the [[sift:application:Explore_Page|Explore Page]].\\
  
- 1. Look through your groups and workspaces by using the [[sift:application:explore_page#plot_controls|plot controls]] to examine and verify your signals and/or metrics on the [[sift:application:explore_page#plot_viewer|plot viewer]]\\+  - Look through your groups and workspaces by using the [[sift:application:explore_page#plot_controls|plot controls]] to examine and verify your signals and/or metrics on the [[sift:application:explore_page#plot_viewer|plot viewer]] 
 +  - Here for example, we have created a 5x4 grid using the [[sift:application:general_options_dialog|options dialog]], and have plotted different groups to check that we are happy with the joint angle, normalization, and quality of the data 
 +  - If you wish to clean your data, see this tutorial [[sift:tutorials:clean_your_data|here]]\\
  
- 2. Here for example, we have created a 3x3 grid using the [[sift:application:general_options_dialog|options dialog]], and have plotted different groups to check that we are happy with the joint angle, normalization, and quality of the data\\+{{sift:tutorials:checkNDQueries.png}}
  
- 3. If you wish to clean your data, see this tutorial [[sift:tutorials:clean_your_data|here]]\\ 
- 
-{{sift:tutorials:checkNDQueries.png}} 
-\\ 
 ==== Build Normal Database Dialog ==== ==== Build Normal Database Dialog ====
  
- 4. On the [[Sift:application:explore_page|Explore Page]], select on the BuildND button{{sift:build_nds:sift_buildNDButton.png?300}}\\ 
-\\ 
 {{ :sift:tutorials:buildNDDlg.png?800}} {{ :sift:tutorials:buildNDDlg.png?800}}
-\\+ 
 + 4. On the [[Sift:application:explore_page|Explore Page]], select on the BuildND button\\ 
 The Build ND Dialog has 3 main sections: **Query Groups**,**Meta Data & Summary Statistics**, and **Summary Level**.\\ The Build ND Dialog has 3 main sections: **Query Groups**,**Meta Data & Summary Statistics**, and **Summary Level**.\\
  
- 5. Select file path and name for resulting ND file. The file path of the ND directs Sift to save the resulting ND CMZ file to a path of the users choice\\+ 5. Select file path and name for resulting ND file. The file path of the ND directs Sift to save the resulting ND .sift file to a path of the users choice\\
  
  6. If you cleaned and excluded data and wish to still use those traces in the ND, check the "Use Excluded Data"\\  6. If you cleaned and excluded data and wish to still use those traces in the ND, check the "Use Excluded Data"\\
  
-=== Query Groups ===+---- 
 +==== Query Groups ====
  
  7. Select all of the queries you wish to include in the ND. Following with the sample data, we will select all queries\\  7. Select all of the queries you wish to include in the ND. Following with the sample data, we will select all queries\\
  
-=== Meta Data & Summary Statistics ===+==== Meta Data & Summary Statistics ====
  
 The Meta Data & Summary Statistics widget of this dialog is populated with all of the available statistics that Sift offers. From this list, you can select as many summary results as you wish to be calculated for all selected Query Groups. A full list of available summary statistics can be found [[Sift:build_nds:ND_Summary_Statistics|here]].\\ The Meta Data & Summary Statistics widget of this dialog is populated with all of the available statistics that Sift offers. From this list, you can select as many summary results as you wish to be calculated for all selected Query Groups. A full list of available summary statistics can be found [[Sift:build_nds:ND_Summary_Statistics|here]].\\
Line 142: Line 139:
  8. For this tutorial, we will select to calculate the **Mean**  8. For this tutorial, we will select to calculate the **Mean**
  
-=== Summary Level ===+==== Summary Level ====
  
 The summary level options allow users to choose how broad or detailed they would like their summaries: The summary level options allow users to choose how broad or detailed they would like their summaries:
Line 154: Line 151:
  
  10. Once you are happy with the dialog settings, select **"Generate Normal Database"**\\  10. Once you are happy with the dialog settings, select **"Generate Normal Database"**\\
- 11. The CMZ file will be generated and automatically loaded into Sift+ 11. The .sift file will be generated and automatically loaded into Sift
  
 ==== View the Normal Database ==== ==== View the Normal Database ====
  
  12. On the [[Sift:application:Load_Page|Load Page]] you will see a summary of the ND you just generated. Here you can see a summary of the files that were used to generate the ND, the summary statistics calculated across the data set, and the summary levels.  12. On the [[Sift:application:Load_Page|Load Page]] you will see a summary of the ND you just generated. Here you can see a summary of the files that were used to generate the ND, the summary statistics calculated across the data set, and the summary levels.
 +
 {{:sift:tutorials:NDLoadedTutorial.png?1000}} {{:sift:tutorials:NDLoadedTutorial.png?1000}}
  
 ===== 5. Use the Normal Database in Sift ===== ===== 5. Use the Normal Database in Sift =====
 \\ \\
-The generated ND file is a CMZ workspace that can be loaded into Sift anytime with the [[sift:build_nds:building_normal_databases#loading_nds|Load ND]] button on the [[sift:application:Explore_Page|Explore Page]].\\+The generated ND file is a .sift workspace that can be loaded into Sift anytime with the [[sift:build_nds:building_normal_databases#loading_nds|Load ND]] button on the [[sift:application:Explore_Page|Explore Page]].\\
  
 Within Sift, users have the flexibility to query, plot, and run any of our analysis tools or statistical tests across ND queries.\\ Within Sift, users have the flexibility to query, plot, and run any of our analysis tools or statistical tests across ND queries.\\
  
 To see how we can continue with this specific Normal Database file to compute Gait Scores, follow the next tutorial [[sift:tutorials:compute_gps_and_gdi|here]]. To see how we can continue with this specific Normal Database file to compute Gait Scores, follow the next tutorial [[sift:tutorials:compute_gps_and_gdi|here]].
sift/tutorials/build_normal_database.1732562311.txt.gz · Last modified: 2024/11/25 19:18 by wikisysop