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/19 12:53] – 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:
-{{{{{{{{{{{{{{{{{{{{{{{{{{building a database of "control" values takes place in four steps:+====== Normative Data From CMO Library ======
  
-  - organize & catalog the cmz files +Building a database of "control" values takes place in four steps:
-  - create a script to define the signals we want to create normal signals for. +
-  - create the normal database. +
-  - save the normal database for use in the future.+
  
-===== sample files =====+  - Organize & Catalog the CMZ files 
 +  - Create a script to define the signals we want to create normal signals for. 
 +  - Create the normal database. 
 +  - Save the normal database for use in the future.
  
-you can download the sample files for this example [[http://c-motion.com/download/examples/createcmolibrary/createnormaldatabase.zip|here]].+==== Sample Files ====
  
-the downloaded file contains:+You can download the sample files for this example [[http://c-motion.com/download/examples/CreateCMOLibrary/CreateNormalDatabase.zip|here]].
  
-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) +The downloaded file contains:
-2. a sample report template (samplereport.rgt) +
-3. a sample script to create a normal database (samplescript.v3s) +
-4. 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.+
  
-===== step 1: organize & catalog the cmo 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) 
 +  - A sample report template (SampleReport.rgt) 
 +  - A sample script to create a normal database (SampleScript.v3s) 
 +  - A sample normal database (NormalDatabase.vnd)
  
-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.+**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.
  
-cmo_lib_fileorg.png+==== Step 1: Organize & Catalog the CMO files ====
  
-**1. organize all the cmz files that you intend to query from into folders within a hierarchy.**+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.
  
-if using the sample files, you must unzip the file. you will see the cmo files in the cmo_lib folder.+{{:CMO_Lib_FileOrg.png}}
  
-**note** the cmz files can be in subfolders as well.\\ +**1. Organize all the CMZ files that you intend to query from into folders within a hierarchy.**
-\\ +
-\\ +
-\\ +
-\\+
  
 +If using the sample files, you must unzip the file. You will see the CMO files in the CMO_Lib folder.
  
-cmo_lib_cmo_path.png+**NOTE** The CMZ files can be in subfolders as well.\\
  
-**2.set visual3d to point to the cmz library (cmo library -> set cmo library path).**+{{:CMO_Lib_CMO_Path.png}}
  
-if using the sample files, point to the cmo_lib folder.\\ +**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.\\
  
-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).**
  
-**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.
  
-**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 ====+;
  
-to automatically create the script, follow the instructions below, you will need a report template:+</code>
  
-**1. load a report template.** you can do this two ways:+=== Option 2: Creating Script based off a Report Template ===
  
-a. open a cmo that has the report/graph of the values you wish to create ”normal” data for. +To automatically create the script, follow the instructions below, you will need a report template:
-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. +
-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]]. +
-**2. create script:**+
  
-1. select from the main menu: **cmo library -> create normal database script**. +**1. Load a report template.** You can do this two ways: 
-normaldb_script_createnormal.png + 
-2. in the pop up window: +A. Open a CMO that has the report/graph of the values you wish to create ”normal” data for.\\ 
-a. specify the name of a folder to save the data (ex. processed) +You can open one of the example CMO files\\ 
-**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. +B. Open a report template that contains the data values you wish to create ”normal” data for.\\ 
-normaldb_script_foldername.png +You can open the sample report template (SampleReport.rgt)\\ 
-b. specify the number of points to normalize to (ex. 101) +**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:** 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 +**2. Create script:** 
-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+1. Select from the main menu: **CMO Library -> Create Normal Database Script**.\\ 
 +{{:NormalDB_Script_CreateNormal.png}}\\ 
 +2. In the pop up window:\\ 
 +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.\\ 
 +{{:NormalDB_Script_FolderName.png}}\\ 
 +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.\\ 
 +{{: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).\\ 
 +{{: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.**
  
-we have now defined what we want to create normal values for. the normal data has not been created yet. so now we need to clear the workspace and load the raw data for this script. this will be accomplished in the next step.\\ +We have now defined what we want to create normal values for. The normal data has NOT been created yet. So now we need to clear the workspace and load the raw data for this script. This will be accomplished in the next step.\\ 
-**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. 
-2. set the active file to global +2. Set the Active File to GLOBAL 
-3. expand the p2d folder +3. Expand the P2D folder 
-4. expand the sub folder (ex. processed) +4. Expand the sub folder (ex. PROCESSED) 
-5. click on a signal (ex. lankleangle_x_lhs_lhs) +5. Click on a signal (ex. LAnkleAngle_X_LHS_LHS) 
-you will see the p2d data tree and the newly processed data there. looking at the data view reveals that: +You will see the P2D Data tree and the newly processed data there. Looking at the data view reveals that: 
-column 1 (x) is the number of data points requested +Column 1 (X) is the number of data points requested 
-column 2 (y) is the mean +Column 2 (Y) is the mean 
-column 3 (z) is the standard deviation. +Column 3 (Z) is the standard deviation. 
-**note:** the [[visual3d:documentation:definitions:file_formats:p2d_format|p2d format]] is simply a historical format for 2d point data storage, and is maintained to provide backward compatibility.+**Note:** The [[Visual3D:Documentation:Definitions:File_Formats:P2D_Format|P2D format]] is simply a historical format for 2D point data storage, and is maintained to provide backward compatibility.
  
 \\ \\
-**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:** 
-set the active file to global +Set the active file to GLOBAL 
-go to the signals and events tab +Go to the Signals and Events tab 
-right-click on the folder name (ex. processed) +Right-click on the folder name (ex. PROCESSED) 
-select export folder to normal database (.vnd)+Select Export Folder to Normal Database (.vnd)
 \\ \\
 \\ \\
Line 164: Line 163:
  
  
-**to save as a .cmz file:** +**To save as a .cmz file:** 
-close the cmo library by going to cmo library -> unload cmo library (unbrowse) +Close the CMO Library by going to CMO Library -> Unload CMO Library (Unbrowse) 
-save the workspace as a cmz file (file -> save)+Save the workspace as a CMZ file (File -> Save) 
  
-}}}}}}}}}}}}}}}}}}}}}}}}}} 
visual3d/documentation/reports/normative_data_from_cmo_library.1718801614.txt.gz · Last modified: 2024/06/19 12:53 by sgranger