Differences

This shows you the differences between two versions of the page.

--- other:inspect3d:documentation:dialogs:build_cmzs [2024/07/12 13:56] – created sgranger
+++ other:inspect3d:documentation:dialogs:build_cmzs [2024/12/17 19:54] (current) – wikisysop
@@ Line 1: / Line 1: @@
-====== Build_CMZs ======
+====== Build CMZs ======
-To load data in Inspect3D 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 Inspect3D 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 Inspect3D you will need to have created [[Visual3D:Documentation:Definitions:File_Formats:CMZ_Format_|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 [[Visual3D:Documentation:Definitions:File_Formats:CMZ_Format_|CMZ files]] in the Visual3D interface. The Build CMZ feature in Inspect3D is designed to automate the generation of CMZ files so that they do not have to be created one by one.
 The Build CMZs feature can be accessed through the [[Other:Inspect3D:Documentation:Dialogs:Load_Library_Dialogue|Load Library]] dialog in Inspect3D.
@@ Line 8: / Line 8: @@
 ===== Build CMZ Dialog =====
+{{ :update_cmzs.png?400}}\\
-{{update_cmzs.png}}
 Clicking the "Build CMZ" button in the Load Library dialog will bring up the GUI shown to the right. There are **four** types of inputs that can be used to build a CMZ:
@@ Line 26: / Line 24: @@
 The only required files to build a CMZ are:
-  * Static/calibration files (.c3d)
+  * **Static/calibration files** (.c3d)
-  * Dynamic/motion trials (.c3d)
+  * **Dynamic/motion trial**s (.c3d)
 The static and dynamic trials you want to combine into a CMZ workspace should be located in the same folder. Passing a file path to this folder to the CMZ Builder is the minimum input required to construct a CMZ workspace. If you have data with multiple subjects, separate the data into folders by subject, ensure that each folder has static and dynamic files, and then pass CMZ builder the path to the parent folder holding all subject folders.
@@ Line 35: / Line 33: @@
 ==== 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 Inspect3D 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 Inspect3D queries after the library has been loaded.
-**MDH File:** An MDH file is an ASCII file that contains the definitions of all landmarks, segments and segment properties. If you want to load segment or landmark information into Inspect3D you must load an MDH file.
+  * **MDH File:** An MDH file is an ASCII file that contains the definitions of all landmarks, segments and segment properties. If you want to load segment or landmark information into Inspect3D you must load an MDH file.
-**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 =====
@@ Line 47: / Line 45: @@
 ==== Warning Messages ====
-**No C3D files without CMZs found. Skipping build.**
+|**"No C3D files without CMZs found. Skipping build."**|This notice shows up when the folder you've selected does not contain any C3D files OR does not contain any C3D files that are not already contained in a CMZ file. Inspect3D will close the Build CMZs dialog without making any changes.|
+|**"Warning: You must select both a static and dynamic identifier to proceed."**|Exactly one static and one dynamic identifier is required in order for Inspect3D to build the CMZ file. Inspect3D will return you to the Metadata dialog.|
-  * This notice shows up when the folder you've selected does not contain any C3D files OR does not contain any C3D files that are not already contained in a CMZ file.
+|**"Warning: Meta Data File not found! Name:."**|Did you forget to Browse to the location of your Metadata file? If you do not intend to include metadata, please uncheck the box next to the Metadata file.|
-  * Inspect3D will close the Build CMZs dialog without making any changes.
+|**"MDH File not found! Name:."**|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.|
-**Warning: You must select both a static and dynamic identifier to proceed.**
-  * Exactly one static and one dynamic identifier is required in order for Inspect3D to build the CMZ file.
-  * Inspect3D will return you to the Metadata dialog.
-**Warning: Meta Data File not found! Name:**
-  * Did you forget to Browse to the location of your Metadata file? If you do not intend to include metadata, please uncheck the box next to the Metadata file.
-**MDH File not found! Name:**
-  * 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 ====
+|**"No information passed. Cannot build CMZs."**|This is an uncommon error. It means there was an issue with the Build CMZs dialog and it is no longer accessible.|
-**No information passed. Cannot build CMZs.**
+|**"No files selected. Cannot build CMZs."**|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 there was an issue with the Build CMZs dialog and it is no longer accessible.
-**No files selected. Cannot build CMZs.**
-  * This is an uncommon error. It means that no files at all were returned by the Build CMZ dialog.