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.
The Build CMZs feature can be accessed through the Load Library dialog in Inspect3D.
Examples of using the Build CMZ function can be found under the Build CMZ Tutorial.
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:
The scripts are run in order, so use the arrow buttons on the right to get the order correct. Note: Scripts added here must all have unique names. The “Add Script” button will not allow you to add the same file multiple times. Expected file type is .v3s.
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 Inspect3D 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).
The only required files to build a CMZ are:
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.
All other inputs are optional.
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.
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.
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.
No C3D files without CMZs found. Skipping build.
Warning: You must select both a static and dynamic identifier to proceed.
Warning: Meta Data File not found! Name:
MDH File not found! Name:
No information passed. Cannot build CMZs.
No files selected. Cannot build CMZs.