HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » sift » tutorials » Compute GPS and GDI
sift:tutorials:compute_gps_and_gdi

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:compute_gps_and_gdi [2024/11/25 21:01] – wikisysopsift:tutorials:compute_gps_and_gdi [2025/02/27 21:32] (current) – wikisysop
Line 2: Line 2:
  
 In this tutorial, we will walk through how to compute the [[sift:gait_measures:gait_profile_score|Gait Profile Score]] (GPS) and  [[sift:gait_measures:gait_deviation_index|Gait Deviation Index]] (GDI) using a Normal Database (ND) we derived in the previous [[Sift:Tutorials:build_normal_database|tutorial]].\\ In this tutorial, we will walk through how to compute the [[sift:gait_measures:gait_profile_score|Gait Profile Score]] (GPS) and  [[sift:gait_measures:gait_deviation_index|Gait Deviation Index]] (GDI) using a Normal Database (ND) we derived in the previous [[Sift:Tutorials:build_normal_database|tutorial]].\\
-\\ +
-\\+
 =====Starting Point===== =====Starting Point=====
  
 If you do not have a [[sift:build_nds:building_normal_databases|Sift ND]] file generated, please follow the previous tutorial BEFORE completing this one: [[Sift:Tutorials:build_normal_database|Build ND Tutorial]]\\ If you do not have a [[sift:build_nds:building_normal_databases|Sift ND]] file generated, please follow the previous tutorial BEFORE completing this one: [[Sift:Tutorials:build_normal_database|Build ND Tutorial]]\\
 +==== Supporting Files ====
 +Download [[https://has-motion.com/download/Tut-GPS_GDI.zip|here]]\\
  
-If you wish to follow this tutorial with a premade Sift ND file, download here: \\+  * **GPS_GDI_Joint_Angles.v3s** - Visual3D Pipeline Script for GPS and GDI required Joint Angles\\ 
 +  * ** ND_Tutorial.sift** - If you wish to follow this tutorial with a premade Sift ND file, download the .sift file. 
  
 ===== 1. Load Library ===== ===== 1. Load Library =====
  
   *On the [[Sift:application:Load_page|Load Page]], select **Load Library** and navigate to the library of CMZ workspaces you wish to compute the GPS and/or GDI measure on. \\   *On the [[Sift:application:Load_page|Load Page]], select **Load Library** and navigate to the library of CMZ workspaces you wish to compute the GPS and/or GDI measure on. \\
-  *If followign along from the previous building ND tutorial, you can load the same [[https://www.has-motion.com/download/examples/V3D_Workshop.zip|V3D Workshop data]]\\+  *If following along from the previous building ND tutorial, you can load the same [[https://www.has-motion.com/download/examples/V3D_Workshop.zip|V3D Workshop data]]\\
  
 ===== 2. Run External Script ===== ===== 2. Run External Script =====
Line 77: Line 79:
   ;   ;
 \\ \\
-{{ sift:tutorials:gpsgditut_loadnd.png?600}}+
 ==== Run V3D Engine Dialog ==== ==== Run V3D Engine Dialog ====
  
-  * To run this script, the [[Sift:application:run_v3d_engine_dialog|Run V3D Engine Dialog]]] can be accessed through the {{:sift_run_v3d.png?30}} button on the [[Sift:Application:Toolbar|toolbar]].\\ +  * To run this script, the [[Sift:application:run_v3d_engine_dialog|Run V3D Engine Dialog]]] can be accessed through the {{:sift_run_v3d.png?30}} button on the [[Sift:Application:Toolbar|toolbar]]. 
- +  * Add the .v3s script downloaded from this tutorial and select **"Run Scripts"**. 
-  * Add the .v3s script downloaded from this tutorial and select **"Run Scripts"**.\\ +  * Wait for the CMZs to update and the library to re-load.
- +
-  * Wait for the CMZs to update and the library to re-load.\\+
  
 ===== 3. Load Sift ND ===== ===== 3. Load Sift ND =====
 +{{ sift:tutorials:gpsgditut_loadnd.png?600}}
  
-  * On the [[Sift:application:Load_page|Load Page]], select **Load ND** and navigate to the Sift ND CMZ file generated in the previous tutorial, or your own Sift ND file. \\ +  * On the [[Sift:application:Load_page|Load Page]], select **Load ND** and navigate to the Sift ND .sift file generated in the previous tutorial, or your own Sift ND file.  
- +  * The Load Page should now display both the library data and ND data, like the image to the right of the page. 
-  * The Load Page should now display both the library data and ND data, like the image to the right of the page.\\ +  * The ND we have loaded contains the 15 kinematic joint angles for the [[sift:gait_measures:gait_profile_score|GPS]] and [[sift:gait_measures:gait_profile_score|GDI]] definitions.  
- +  * The ND also has a Mean summary statistic signal for both Workspace and Library level. Both workspace means and the library mean are **REQUIRED** for the GDI measure. The Library level mean signal is **REQUIRED** for the GPS.
-  * The ND we have loaded contains the 15 kinematic joint angles for the [[sift:gait_measures:gait_profile_score|GPS]] and [[sift:gait_measures:gait_profile_score|GDI]] definitions. \\ +
- +
-  * The ND also has a Mean summary statistic signal for both Workspace and Library level. Both workspace means and the library mean are **REQUIRED** for the GDI measure. The Library level mean signal is **REQUIRED** for the GPS.\\ +
   * **Note** that the ND and loaded library in this particular example are from the same underlying database. This DOES NOT need to be the case to follow this tutorial if using your own data.   * **Note** that the ND and loaded library in this particular example are from the same underlying database. This DOES NOT need to be the case to follow this tutorial if using your own data.
  
 **IF** your Sift ND file does not follow these requirements, please follow the previous tutorial [[Sift:Tutorials:build_normal_database|here]] to build a ND with the correct summary data.\\ **IF** your Sift ND file does not follow these requirements, please follow the previous tutorial [[Sift:Tutorials:build_normal_database|here]] to build a ND with the correct summary data.\\
  
 +----
 ===== 4. Compute Gait Score ===== ===== 4. Compute Gait Score =====
  
Line 136: Line 134:
   * Select the Signal Folder, events to normalize to for left and right side, and number of normalized points. Here we are sticking to the default LHS, RHS, and 51 points, aligning with the [[sift:gait_measures:gait_profile_score|GPS definition]].   * Select the Signal Folder, events to normalize to for left and right side, and number of normalized points. Here we are sticking to the default LHS, RHS, and 51 points, aligning with the [[sift:gait_measures:gait_profile_score|GPS definition]].
 {{ :sift:gait_measures:eventandfolder_gpsdlg.png?500 }} {{ :sift:gait_measures:eventandfolder_gpsdlg.png?500 }}
-  * Click on "Signal Selection" to open the second [[sift:gait_measures:gait_measures#gait_profile_score|GPS Dialog]]+  * Click on "Signal Selection" to open the second [[sift:gait_measures:gait_measures#gait_deviation_index|GDI Dialog]]
  
   * Select the signals from the loaded library (**Signal** column) with the components that correspond to the kinematic measure (**Signal Name** column)   * Select the signals from the loaded library (**Signal** column) with the components that correspond to the kinematic measure (**Signal Name** column)
Line 145: Line 143:
 {{ :sift:tutorials:gpsdlgselects.png?700 }} {{ :sift:tutorials:gpsdlgselects.png?700 }}
  
-  * Select **"Compute GPS"**+  * Select **"Compute GDI"**
  
-  * The CMZ's will update and the GPS queries will be automatically loaded into the [[:sift:application:Explore_Page|Explore Page]]+  * The CMZ's will update and the GDI queries will be automatically loaded into the [[:sift:application:Explore_Page|Explore Page]]
  
-  * The results of the GPS are saved in the METRIC data type of the Visual3D data tree. If you wish to query the GPS signals again in the future, you can find them in Folder GPS1. You can also query the GVS values for each component in folders GVS_L_1 and GVS_R_1. The "1" indicates that this is the first GPS measure in these files. If you compute the GPS again on this dataset with a different ND or different settings, the results will not be overwritten. +  * The results of the GDI are saved in the METRIC data type of the Visual3D data tree. If you wish to query the GPS signals again in the future, you can find them in Folder GDI1. The "1" indicates that this is the first GPS measure in these files. If you compute the GPS again on this dataset with a different ND or different settings, the results will not be overwritten. 
-{{ :sift:tutorials:gps1queryex.png?700 }}+{{ :sift:tutorials:gdi1queryex.png?700 }}
 ===== 5. Visualize Results ===== ===== 5. Visualize Results =====
 +  * Navigate to the [[:sift:application:Explore_Page|Explore Page]] and change the plot type to **"Metric Plot"** 
 +  * Plot the GPS1 and/or GDI1 groups with all or select workspaces 
 +  * Select **"Plot Workspace Mean"** and group by **Workspace** 
 +  * Now we can visualize the GPS and GDI measures within Sift 
 +{{ sift:tutorials:GPSGDIResults.png?1000 }} 
 +{{ sift:tutorials:GPSExportSettings.png?400}} 
 +===== 6. Exporting Results ===== 
 +  * GPS/GDI results can be exported via Sift's [[sift:export:export_results_dialog|Export Results Dialog]] 
 +  * Here we can export the plotted data to a text file to save our results 
 +  * We can also export the graph of the results via Sift's [[sift:export:export_graphs_dialog|Export Graphs Dialog]]
sift/tutorials/compute_gps_and_gdi.1732568488.txt.gz · Last modified: 2024/11/25 21:01 by wikisysop