HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » reports » Normative Data From CMO Library
visual3d:documentation:reports:normative_data_from_cmo_library

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
visual3d:documentation:reports:normative_data_from_cmo_library [2024/07/03 17:44] – created sgrangervisual3d:documentation:reports:normative_data_from_cmo_library [2024/11/04 15:47] (current) – [Step 3: Create the normal database] wikisysop
Line 1: Line 1:
-====== Normative_Data_From_CMO_Library ======+====== Normative Data From CMO Library ======
  
 Building a database of "control" values takes place in four steps: Building a database of "control" values takes place in four steps:
Line 14: Line 14:
 The downloaded file contains: The downloaded file contains:
  
-1. A sample CMO library containing two CMO files (Sub01_Walk.cmo & Sub02_Walk.cmo) (These CMO files should work the same as CMZ files) +  - A sample CMO library containing two CMO files (Sub01_Walk.cmo & Sub02_Walk.cmo) (These CMO files should work the same as CMZ files) 
-2. A sample report template (SampleReport.rgt) +  - A sample report template (SampleReport.rgt) 
-3. A sample script to create a normal database (SampleScript.v3s) +  - A sample script to create a normal database (SampleScript.v3s) 
-4. A sample normal database (NormalDatabase.vnd)+  - A sample normal database (NormalDatabase.vnd) 
 **Note:** Visual3D now uses the updated and improved [[Visual3D:Documentation:Definitions:File_Formats:CMZ_Format_|CMZ format]], which will work identically for the purposes of this example. **Note:** Visual3D now uses the updated and improved [[Visual3D:Documentation:Definitions:File_Formats:CMZ_Format_|CMZ format]], which will work identically for the purposes of this example.
  
Line 24: Line 25:
 The first time you load the CMZ (CMO) library, you must organize the files. You do not need to do this each time you load the CMZ Library, however, if you move the CMZ files to different locations on your computer, this section should be done again. The first time you load the CMZ (CMO) library, you must organize the files. You do not need to do this each time you load the CMZ Library, however, if you move the CMZ files to different locations on your computer, this section should be done again.
  
-{{CMO_Lib_FileOrg.png}}+{{:CMO_Lib_FileOrg.png}}
  
 **1. Organize all the CMZ files that you intend to query from into folders within a hierarchy.** **1. Organize all the CMZ files that you intend to query from into folders within a hierarchy.**
Line 31: Line 32:
  
 **NOTE** The CMZ files can be in subfolders as well.\\ **NOTE** The CMZ files can be in subfolders as well.\\
-\\ 
-\\ 
-\\ 
-\\ 
  
- +{{:CMO_Lib_CMO_Path.png}}
-{{CMO_Lib_CMO_Path.png}}+
  
 **2.Set Visual3D to point to the CMZ Library (CMO Library -> Set CMO Library Path).** **2.Set Visual3D to point to the CMZ Library (CMO Library -> Set CMO Library Path).**
  
 If using the sample files, point to the CMO_Lib folder.\\ If using the sample files, point to the CMO_Lib folder.\\
-\\ 
-\\ 
-\\ 
  
- +{{:CMO_Lib_Catalog.png}}
-{{CMO_Lib_Catalog.png}}+
  
 **3. Catalog the Library (CMO Library -> Maintenance -> Catalog CMO Files).** **3. Catalog the Library (CMO Library -> Maintenance -> Catalog CMO Files).**
Line 61: Line 53:
 **Note:** If you are using a premade pipeline any variables you wish to save in the .vnd file needs to be saved using the [[Visual3D:Documentation:Pipeline:Signal_Commands:Global_Normalized_Signal_Mean|Global_Normalized_Signal_Mean]]. **Note:** If you are using a premade pipeline any variables you wish to save in the .vnd file needs to be saved using the [[Visual3D:Documentation:Pipeline:Signal_Commands:Global_Normalized_Signal_Mean|Global_Normalized_Signal_Mean]].
  
-**Global_Normalized_Signal_Mean** +<code> 
-/**SIGNAL_TYPES**=LINK_MODEL_BASED+LINK_MODEL_BASED +Global_Normalized_Signal_Mean 
-/**SIGNAL_NAMES**=RKNEE_ANGLE+LKNEE_ANGLE +/SIGNAL_TYPES=LINK_MODEL_BASED+LINK_MODEL_BASED 
-/**SIGNAL_FOLDER**=ORIGINAL+ORIGINAL +/SIGNAL_NAMES=RKNEE_ANGLE+LKNEE_ANGLE 
-**/SIGNAL_COMPONENTS**=X+X +/SIGNAL_FOLDER=ORIGINAL+ORIGINAL  
-**/START_LABEL**= +/SIGNAL_COMPONENTS=X+X 
-**/END_LABEL**= +/START_LABEL=  
-**/EVENT_SEQUENCE**= RHS+RHS++LHS+LHS +/END_LABEL=  
-**! /EXCLUDE_EVENTS**= +/EVENT_SEQUENCE= RHS+RHS++LHS+LHS 
-**/RESULT_NAME**=KNEE_FLEXION +! /EXCLUDE_EVENTS= 
-**! /RESULT_FOLDER**=ORIGINAL +/RESULT_NAME=KNEE_FLEXION 
-**/NORMALIZE_POINTS**=101 +! /RESULT_FOLDER=ORIGINAL 
-**/CREATE_STANDARD_DEVIATION**=TRUE +/NORMALIZE_POINTS=101 
-**! /CALCULATE_PER_FILE**=FALSE +/CREATE_STANDARD_DEVIATION=TRUE 
-**;**+! /CALCULATE_PER_FILE=FALSE 
 +; 
 + 
 +</code> 
 === Option 2: Creating Script based off a Report Template === === Option 2: Creating Script based off a Report Template ===
  
Line 82: Line 78:
 **1. Load a report template.** You can do this two ways: **1. Load a report template.** You can do this two ways:
  
-A. Open a CMO that has the report/graph of the values you wish to create ”normal” data for. +A. Open a CMO that has the report/graph of the values you wish to create ”normal” data for.\\ 
-You can open one of the example CMO files +You can open one of the example CMO files\\ 
-B. Open a report template that contains the data values you wish to create ”normal” data for. +B. Open a report template that contains the data values you wish to create ”normal” data for.\\ 
-You can open the sample report template (SampleReport.rgt) +You can open the sample report template (SampleReport.rgt)\\ 
-**Note:** If you are following the Gait Profile Score Tutorial the use this [[https://www.has-motion.com/download/examples/GaitProfileScore/ReportTemplate.rgt|report template]].+**Note:** If you are following the Gait Profile Score Tutorial the use this [[https://www.has-motion.com/download/examples/GaitProfileScore/ReportTemplate.rgt|report template]].\\ 
 **2. Create script:** **2. Create script:**
  
-1. Select from the main menu: **CMO Library -> Create Normal Database Script**. +1. Select from the main menu: **CMO Library -> Create Normal Database Script**.\\ 
-{{NormalDB_Script_CreateNormal.png}} +{{:NormalDB_Script_CreateNormal.png}}\\ 
-2. In the pop up window: +2. In the pop up window:\\ 
-A. Specify the name of a folder to save the data (ex. PROCESSED) +A. Specify the name of a folder to save the data (ex. PROCESSED)\\ 
-**NOTE:** If you are going to plot two normal databases in one CMZ file (ex. Walk and Run), you should name the different folders "WALK" and "RUN" here. +**NOTE:** If you are going to plot two normal databases in one CMZ file (ex. Walk and Run), you should name the different folders "WALK" and "RUN" here.\\ 
-{{NormalDB_Script_FolderName.png}} +{{:NormalDB_Script_FolderName.png}}\\ 
-B. Specify the number of points to normalize to (ex. 101) +B. Specify the number of points to normalize to (ex. 101)\\ 
-**NOTE:** Typically this would match the number of points you normalize your graphs to in the report template (Normalize 0 to 100%) so 101 points is used most often. +**NOTE:** Typically this would match the number of points you normalize your graphs to in the report template (Normalize 0 to 100%) so 101 points is used most often.\\ 
-{{NormalDB_Script_NumPoints.png}} +{{:NormalDB_Script_NumPoints.png}}\\ 
-C. Create normals/means for all the graphs in the report (optionally, use only those graphs that have mean values graphed). +C. Create normals/means for all the graphs in the report (optionally, use only those graphs that have mean values graphed).\\ 
-{{NormalDB_Script_AllOrMeansOnly.png}}+{{:NormalDB_Script_AllOrMeansOnly.png}}\\
 \\ \\
 **3. View the created script in the Pipeline.** **3. View the created script in the Pipeline.**
  
-There will be one command in the pipeline for every graph item in the report (or every one with a mean graphed if that option was selected). This means if you want to average the right/left together, you will need to modify the script to do this. +There will be one command in the pipeline for every graph item in the report (or every one with a mean graphed if that option was selected). This means if you want to average the right/left together, you will need to modify the script to do this.\\ 
-**Note:** Running this wizard will create the command "Global_Normalized_Signal_Mean” and fill in the parameters for you whether you have the pipeline dialog open or not. Any time you choose to create this script automatically, it will append the results to anything that is in the pipeline workshop. +**Note:** Running this wizard will create the command "Global_Normalized_Signal_Mean” and fill in the parameters for you whether you have the pipeline dialog open or not. Any time you choose to create this script automatically, it will append the results to anything that is in the pipeline workshop.\\ 
-{{Global_Normailized_Signal_Mean_New2.png}}+{{:Global_Normailized_Signal_Mean_New2.png}}\\
 \\ \\
 **4. Save the Pipeline script.** **4. Save the Pipeline script.**
Line 116: Line 113:
 **1. Clear out the entire Visual3D workspace** **1. Clear out the entire Visual3D workspace**
  
-(File -> New, or restart Visual3D) +(File -> New, or restart Visual3D)\\ 
-{{CMO_Lib_FileNew.png}}+{{:CMO_Lib_FileNew.png}}\\
  
 **2. Browse the CMO Library.** **2. Browse the CMO Library.**
  
-From the main menu, select CMO Library -> Browse. +From the main menu, select CMO Library -> Browse.\\ 
-{{CMO_Lib_BrowseLib.png}}+{{:CMO_Lib_BrowseLib.png}}\\
  
 **3. Set the Active File to EACH_CMO_WORKSPACE** **3. Set the Active File to EACH_CMO_WORKSPACE**
  
-To select only specific files, create a new Tag, check the files to use, and select the tag name in the combo box. +To select only specific files, create a new Tag, check the files to use, and select the tag name in the combo box.\\ 
-{{CMO_Lib_ActiveFile.png}}+{{:CMO_Lib_ActiveFile.png}}\\
  
 **4. Execute the script to create the normal database** **4. Execute the script to create the normal database**
  
-To select only specific files, create a new Tag, check the files to use, and select the tag name in the combo box.+To select only specific files, create a new Tag, check the files to use, and select the tag name in the combo box.\\
 Execute the script that was saved earlier. Execute the script that was saved earlier.
 ==== Step 4: Save the normal database ==== ==== Step 4: Save the normal database ====
Line 137: Line 134:
 **1. Check that the P2D signals were created.** **1. Check that the P2D signals were created.**
  
-{{CMOLib_DataView.png}}+{{:CMOLib_DataView.png}}
  
 1. Switch to Signal and Event Processing tab. 1. Switch to Signal and Event Processing tab.
Line 153: Line 150:
 **2. Save the Normal Data as a ”Normal” database.** You can save the normal database as a .vnd file, or a .cmo file. **2. Save the Normal Data as a ”Normal” database.** You can save the normal database as a .vnd file, or a .cmo file.
  
-{{CMOLib_SaveVND.png}}+{{:CMOLib_SaveVND.png}}
  
 **To save as a .vnd file:** **To save as a .vnd file:**
visual3d/documentation/reports/normative_data_from_cmo_library.1720028657.txt.gz · Last modified: 2024/07/03 17:44 by sgranger