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/06/18 13:34] – 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 ======
 +
 Building a database of "control" values takes place in four steps: Building a database of "control" values takes place in four steps:
  
Line 6: Line 8:
   - Save the normal database for use in the future.   - Save the normal database for use in the future.
  
-===== Sample Files =====+==== Sample Files ====
  
 You can download the sample files for this example [[http://c-motion.com/download/examples/CreateCMOLibrary/CreateNormalDatabase.zip|here]]. You can download the sample files for this example [[http://c-motion.com/download/examples/CreateCMOLibrary/CreateNormalDatabase.zip|here]].
Line 12: 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.
  
-===== Step 1: Organize & Catalog the CMO files =====+==== Step 1: Organize & Catalog the CMO files ====
  
 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 29: 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 51: Line 45:
 **NOTE:** When you select "Catalog CMO Files", Visual3D goes through all the CMZ files, and ensures that the CMX file is up to date with the CMZ file. If you have not deleted your CMX files, or moved the CMZ/CMX files to different locations, you do not need to do this. Typically, I recommend cataloging the CMZ files the first time you use the library. **NOTE:** When you select "Catalog CMO Files", Visual3D goes through all the CMZ files, and ensures that the CMX file is up to date with the CMZ file. If you have not deleted your CMX files, or moved the CMZ/CMX files to different locations, you do not need to do this. Typically, I recommend cataloging the CMZ files the first time you use the library.
  
-===== Step 2: Creating a script to define the signals in the normal database =====+==== Step 2: Creating a script to define the signals in the normal database ====
  
-==== Option 1: Using a Premade Pipeline ====+=== Option 1: Using a Premade Pipeline ===
  
 If you already have a premade pipeline, you can skip ahead to Step 3. If you already have a premade pipeline, you can skip ahead to Step 3.
Line 59: 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 
-==== Option 2: Creating Script based off a Report Template ====+; 
 + 
 +</code> 
 + 
 +=== Option 2: Creating Script based off a Report Template ===
  
 To automatically create the script, follow the instructions below, you will need a report template: To automatically create the script, follow the instructions below, you will need a report template:
Line 80: 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 110: Line 109:
 **Note:** An alternative to the Wizard approach is to create/edit the command from pipeline directly using the [[Visual3D:Documentation:Pipeline:Signal_Commands:Global_Normalized_Signal_Mean|Global_Normalized_Signal_Mean]] command. Note that the wizard added the desired data to the list at the bottom of the [[Visual3D:Documentation:Pipeline:Signal_Commands:Global_Normalized_Signal_Mean|Global_Normalized_Signal_Mean]] command dialog box. You can enter and ADD new values here as well. **Note:** An alternative to the Wizard approach is to create/edit the command from pipeline directly using the [[Visual3D:Documentation:Pipeline:Signal_Commands:Global_Normalized_Signal_Mean|Global_Normalized_Signal_Mean]] command. Note that the wizard added the desired data to the list at the bottom of the [[Visual3D:Documentation:Pipeline:Signal_Commands:Global_Normalized_Signal_Mean|Global_Normalized_Signal_Mean]] command dialog box. You can enter and ADD new values here as well.
  
-===== Step 3: Create the normal database =====+==== Step 3: Create the normal database ====
  
 **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 ====
  
 **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 151: 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.1718717665.txt.gz · Last modified: 2024/06/18 13:34 by sgranger