Differences

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

--- sift:build_cmz:load_c3ds_dialog [2025/04/22 13:01] – [Build CMZ Dialog - Theia Builder] wikisysop
+++ sift:build_cmz:load_c3ds_dialog [2025/04/25 19:15] (current) – Grouped the extended "new paragraph" lists to clarify the page's organization. wikisysop
@@ Line 1: / Line 1: @@
 ====== Load C3Ds Dialog ======
-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 [[visual3d:documentation:definitions:file_formats:cmz_format|CMZ files]], which 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. Sift's Build CMZ feature automates the generation of CMZ files so that C3D files can be directly loaded without having to initially create CMZ files one by one. The Build CMZs feature can be accessed using the Load C3Ds button on the [[Sift:Application:Load_Page|Load Page]] in Sift.
-The Build CMZs feature can be accessed on the [[Sift:Application:Load_Page|Load Page]] in Sift.
-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 =====
@@ Line 36: / Line 32: @@
 ==== 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.
+  * **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 Sift 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 Sift 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 ====
-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 ===
-**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.
-  * Sift 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 Sift to build the CMZ file.
-  * Sift 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 files selected. Cannot build CMZs.**
-  * This is an uncommon error. It means that no files at all were returned by the Build CMZ dialog.
+^ Warning Messages ^ ^ ^
+|**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. | Sift 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 Sift to build the CMZ file. | Sift 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 files selected. Cannot build CMZs.**| This is an uncommon error. It means that no files at all were returned by the Build CMZ dialog.| |
 ===== Build CMZ Dialog - Theia Builder =====
@@ Line 80: / Line 53: @@
 {{ :Sift_TheiaBuilder.png?800}}
-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 Visual3D's [[visual3d:tutorials:theia:theia3d_merge|Manage_File_Merge]] command. This is also accessed from the "Load C3Ds" button on the Load page. 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.
+  * **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.
-There are a variety of inputs that can be used to generate CMZs from Theia3D files:
+Three mutually exclusive merge options are presented:
+  * **Merge Theia3D Files:** Merge primary Theia3D files into other Theia3D files.
+  * **Import Analog Files:** Merge primary Theia3D files with analog files, such as force plate data.
+  * **Merge Theia Files and Other Files:** Merge primary Theia3D files with other data, such as marker-based files (mutually exclusive).
-**CMZ Directory:** The directory root to search for all of the Theia3D Files.
+If analog files will be merged into the motion capture files, then additional parameters are required:
+  * **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.
-\\
+Finally, some overall parameters can be passed to control how the merge is conducted:
-**Save By:** How the CMZ file should be saved as.
+  * **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.
-**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.
-\\
-**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:
+  * **CMZs not opened by default:** you need to load these in through the [[Sift:Application:Load_Library_Dialog|load library]] dialog into Sift.
+  * **Automatic Save is on by default:** you just need to select how to save from the given options.
-**CMZs not opened by default:** you need to load these in through the [[Sift:Application:Load_Library_Dialog|load library]] dialog into Sift.
+===== Tutorial =====
-**Automatic Save is on by default:** you just need to select how to save from the given options.
+Examples of using the Build CMZ function can be found under the [[Sift:Tutorials:OpenBiomechanics_Project:Build_CMZ_Files|Build CMZ Tutorial]].