HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » sift » build_cmz » Building CMZs
sift:build_cmz:building_cmzs

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:build_cmz:building_cmzs [2024/06/19 13:54] – created sgrangersift:build_cmz:building_cmzs [2025/03/21 19:49] (current) – wikisysop
Line 1: Line 1:
 +====== Building CMZs ======
 +
 To load data in Sift you will need to have created CMZ files. CMZ files are compressed Visual3D workspaces that contain both pure data and calculated values. If you are familiar with Visual3D, you may already know how to create CMZ files in the Visual3D interface. The Build CMZ feature in Sift is designed to automate the generation of CMZ files so that they do not have to be created one by one. To load data in Sift you will need to have created CMZ files. CMZ files are compressed Visual3D workspaces that contain both pure data and calculated values. If you are familiar with Visual3D, you may already know how to create CMZ files in the Visual3D interface. The Build CMZ feature in Sift is designed to automate the generation of CMZ files so that they do not have to be created one by one.
  
Line 5: Line 7:
 Examples of using the Build CMZ function can be found under the [[Sift:Tutorials:OpenBiomechanics_Project:Build_CMZ_Files|Build CMZ Tutorial]]. Examples of using the Build CMZ function can be found under the [[Sift:Tutorials:OpenBiomechanics_Project:Build_CMZ_Files|Build CMZ Tutorial]].
  
-====== Build CMZ Dialog - Generic Builder ======+===== Build CMZ Dialog - Generic Builder =====
  
-{{GenericBuilder.png}}+{{ :GenericBuilder.png}}
  
 Clicking the "Load C3Ds" button on the Load page will bring up the GUI shown to the right, including the Generic CMZ Builder and the Theia Builder. This section focuses on the generic CMZ builder. There are **four** types of inputs that can be used to build a CMZ for the generic builder: Clicking the "Load C3Ds" button on the Load page will bring up the GUI shown to the right, including the Generic CMZ Builder and the Theia Builder. This section focuses on the generic CMZ builder. There are **four** types of inputs that can be used to build a CMZ for the generic builder:
Line 20: Line 22:
 After all files have been uploaded, click the **"Create CMZs"** button. This button combines all the C3D files in the CMZ Directory folder into one CMZ file that Sift can then load as a library. It includes the metadata, applies the model to all the C3D files, and runs the scripts in order. When this button is pressed, the Metadata window will open (if a metadata file has been provided). After all files have been uploaded, click the **"Create CMZs"** button. This button combines all the C3D files in the CMZ Directory folder into one CMZ file that Sift can then load as a library. It includes the metadata, applies the model to all the C3D files, and runs the scripts in order. When this button is pressed, the Metadata window will open (if a metadata file has been provided).
  
-===== Minimum Inputs =====+==== Minimum Inputs ====
  
 The only required files to build a CMZ are: The only required files to build a CMZ are:
Line 31: Line 33:
 All other inputs are optional. All other inputs are optional.
  
-===== Optional Inputs =====+==== Optional Inputs ====
  
 **Metadata File:** Metadata files contain supplementary information about the data you are loading (subject age, weight, walking speed, etc.) Metadata files can be used to refine Sift queries after the library has been loaded. **Metadata File:** Metadata files contain supplementary information about the data you are loading (subject age, weight, walking speed, etc.) Metadata files can be used to refine Sift queries after the library has been loaded.
Line 39: Line 41:
 **Scripts:** An ASCII file containing a series of Visual3D pipeline commands, with the extension .v3s. You would load scripts if you wanted to run a Visual3D pipeline on the created CMZ workspace. **Scripts:** An ASCII file containing a series of Visual3D pipeline commands, with the extension .v3s. You would load scripts if you wanted to run a Visual3D pipeline on the created CMZ workspace.
  
-===== Troubleshooting =====+==== Troubleshooting ====
  
 This section contains a list of the error messages you may encounter while using the Build CMZ and metadata functions. The Build CMZ dialog and metadata windows expect reasonably specific input and may not execute if files or expected inputs are missing. This section contains a list of the error messages you may encounter while using the Build CMZ and metadata functions. The Build CMZ dialog and metadata windows expect reasonably specific input and may not execute if files or expected inputs are missing.
  
-==== Warning Messages ====+=== Warning Messages ===
  
 **No C3D files without CMZs found. Skipping build.** **No C3D files without CMZs found. Skipping build.**
Line 63: Line 65:
   * Did you forget to Browse to the location of your MDH file? If you do not intend to include a model file, please uncheck the box next to the MDH file.   * Did you forget to Browse to the location of your MDH file? If you do not intend to include a model file, please uncheck the box next to the MDH file.
  
-==== Error Messages ====+=== Error Messages ===
  
 **No information passed. Cannot build CMZs.** **No information passed. Cannot build CMZs.**
Line 73: Line 75:
   * This is an uncommon error. It means that no files at all were returned by the Build CMZ dialog.   * This is an uncommon error. It means that no files at all were returned by the Build CMZ dialog.
  
-====== Build CMZ Dialog - Theia Builder ======+===== Build CMZ Dialog - Theia Builder =====
  
-{{Sift_TheiaBuilder.png}}+{{ :Sift_TheiaBuilder.png}}
  
 This section focuses on the Theia Builder, which builds CMZ files from Theia3D outputs. This dialog closely matches the dialog for building Theia3D files in Visual3D, "Manage_Theia3D_Merge". This is also accessed from the "Load C3Ds" button on the Load page. This section focuses on the Theia Builder, which builds CMZ files from Theia3D outputs. This dialog closely matches the dialog for building Theia3D files in Visual3D, "Manage_Theia3D_Merge". This is also accessed from the "Load C3Ds" button on the Load page.
Line 81: Line 83:
 There are a variety of inputs that can be used to generate CMZs from Theia3D files: There are a variety of inputs that can be used to generate CMZs from Theia3D files:
  
-**CMZ Directory:** The directory root to search for all of the Theia3D Files. +  * **CMZ Directory:** The directory root to search for all of the Theia3D Files.
- +
-\\ +
-**Save By:** How the CMZ file should be saved as. +
- +
-**Use Index Theia Files (.hmx):** If you would like to use a .hmx file to supersede this information. +
- +
-\\ +
-**File Tags:** If/how file tags should be added onto the files by. +
- +
-\\ +
-**Primary Data Folder:** Method by which Theia3D data is stored. +
- +
-**Theia Session Folder Mask:** Folder mask for Theia3d files (directory within top level directory to search for Theia3D files). +
- +
-**Theia File Mask:** File name mask for Theia3D files. Can include wildcards. +
- +
-**Theia File Mask for Model:** File name mask for model file. If blank it will select the first file as the model file. Can include wildcards. +
- +
-**Theia Subject Tags:** Subject tags for Theia3D files. +
- +
-**Theia Prefixes:** **Subject prefixes for Theia3D files.** +
- +
-**Theia Color:** The color of the Theia3D skeleton. +
- +
-**Choose Kinetic Thorax:** Choose which type of thorax to model. +
- +
-\\ +
- +
- +
-**Merge Theia3D Files:** Merge primary Theia3D files into other Theia3D files (mutually exclusive). +
- +
-**Import Analog Files:** Merge primary Theia3D files with analog files, such as force plate data (mutually exclusive). +
- +
-**Merge Theia Files and Other Files:** Merge primary Theia3D files with other data, such as marker-based files (mutually exclusive). +
- +
-\\ +
- +
- +
-**Secondary Data Folder:** Method by which secondary data is stored. +
- +
-**Static Data Folder:** Method by which static secondary data is stored. +
- +
-**Other Session Folder Mask:** Folder mask for merged files (directory within top level directory to search for merged files). +
- +
-**Other File Mask:** File name mask for merged files. Can include wildcards. +
- +
-**Other Static File Mask:** File name mask for static merged files. Can include wildcards. +
- +
-**Other Model Template Mask:** File name mask for model files (if needed). Can include wildcards. +
- +
-**Other Subject Tags:** Subject tags for merged files. +
- +
-**Other Prefixes:** **Subject prefixes for merged files.** +
- +
-**Other Color:** The color of the secondary data files. +
- +
-**Analog Filter Cutoff:** The lowpass filter cutoff for the analog files. +
- +
-**Target Filter Cutoff:** The lowpass filter cutoff for the target files.+
  
-**FP_Auto_Baseline:** Method by which forceplate data was collected.+  * **Save By:** How the CMZ file should be saved as. 
 +  * **Use Index Theia Files (.hmx):** If you would like to use a .hmx file to supersede this information. 
 +  * **File Tags:** If/how file tags should be added onto the files by.
  
-\\+**Primary:** 
 +  * **Primary Data Folder:** Method by which Theia3D data is stored. 
 +  * **Theia Session Folder Mask:** Folder mask for Theia3d files (directory within top level directory to search for Theia3D files). 
 +  * **Theia File Mask:** File name mask for Theia3D files. Can include wildcards. 
 +  * **Theia File Mask for Model:** File name mask for model file. If blank it will select the first file as the model file. Can include wildcards. 
 +  * **Theia Subject Tags:** Subject tags for Theia3D files. 
 +  * **Theia Prefixes:** **Subject prefixes for Theia3D files.** 
 +  * **Theia Color:** The color of the Theia3D skeleton. 
 +  * **Choose Kinetic Thorax:** Choose which type of thorax to model.
  
 +  * **Merge Theia3D Files:** Merge primary Theia3D files into other Theia3D files (mutually exclusive).
 +  * **Import Analog Files:** Merge primary Theia3D files with analog files, such as force plate data (mutually exclusive).
 +  * **Merge Theia Files and Other Files:** Merge primary Theia3D files with other data, such as marker-based files (mutually exclusive).
  
-**Restrict Number of Session Files:** Restricts the number of session files used.+**Secondary:**
  
-**Visual3D Pipeline Pre-Merge:** Visual 3D pipeline to run before the merge occurs.+  * **Secondary Data Folder:** Method by which secondary data is stored. 
 +  * **Static Data Folder:** Method by which static secondary data is stored. 
 +  * **Other Session Folder Mask:** Folder mask for merged files (directory within top level directory to search for merged files). 
 +  * **Other File Mask:** File name mask for merged files. Can include wildcards. 
 +  * **Other Static File Mask:** File name mask for static merged files. Can include wildcards. 
 +  * **Other Model Template Mask:** File name mask for model files (if needed). Can include wildcards. 
 +  * **Other Subject Tags:** Subject tags for merged files. 
 +  * **Other Prefixes:** **Subject prefixes for merged files.** 
 +  * **Other Color:** The color of the secondary data files. 
 +  * **Analog Filter Cutoff:** The lowpass filter cutoff for the analog files. 
 +  * **Target Filter Cutoff:** The lowpass filter cutoff for the target files. 
 +  * **FP_Auto_Baseline:** Method by which forceplate data was collected.
  
-**Visual3D Pipeline Post-Merge:** Visual 3D pipeline to run after the merge occurs.+  * **Restrict Number of Session Files:** Restricts the number of session files used. 
 +  * **Visual3D Pipeline Pre-Merge:** Visual 3D pipeline to run before the merge occurs. 
 +  * **Visual3D Pipeline Post-Merge:** Visual 3D pipeline to run after the merge occurs.
  
-\\ 
 Differences from the Visual3D Dialog include: Differences from the Visual3D Dialog include:
  
sift/build_cmz/building_cmzs.1718805281.txt.gz · Last modified: 2024/06/19 13:54 by sgranger