====== Build CMZ Files ======

Through the OpenBiomechanics Project, Driveline Baseball has made elite-level motion capture data publicly available. The data can be downloaded from [[https://github.com/drivelineresearch/openbiomechanics|Driveline's GitHub repository]].

Having access to large datasets is a great asset, but processing these large datasets can take time (and patience). Sift is designed to streamline this process. The steps in this tutorial describe how to create [[visual3d:documentation:definitions:file_formats:cmz_format|CMZ]] files from the raw [[visual3d:documentation:third-party:motion_analysis:c3d_file|C3D]] files from pitching and batting data sets, then inspect and group the data in Sift.

===== Downloads and Relevant Links =====

Begin with downloading the following two zip files.

  - [[https://github.com/drivelineresearch/openbiomechanics|OpenBiomechanics Project: Driveline Baseball data]] (download the entire openbiomechanics folder and it's contents)
  - [[https://www.has-motion.com/download/Katie/Driveline_CMotionFiles.zip|HAS-Motion Specific Files]]

Please note, these downloads contain a large amount of data. Building CMZs is a slow process, so if you want to speed it up to follow along with this tutorial cut the number of datasets under openbiomechanics-main down to 3-5 subjects.

For more technical information on the Build CMZ feature, see: [[Sift:Build_CMZ:Building_CMZs|Build CMZs Documentation]]

===== Build CMZs for Pitching Data =====

First open a new Sift workspace.\\

On the [[sift:application:Load_page|Load Page]], select "Load C3Ds"\\

In the [[sift:build_cmz:load_c3ds_dialog| Load C3Ds Dialog]] under **Generic Builder**:

  - **Set the CMZ Directory to:** C:\...\openbiomechanics-main\baseball_pitching\data\c3d
  - **Set the Metadata to:** C:\...\openbiomechanics-main\baseball_pitching\data\metadata.csv
  - **Set the MDH File to:** C:\...\openbiomechanics-main\baseball_pitching\code\v3d\model\v6_model_hybrid_lm.mdh
  - Add the following scripts and ensure they are in the correct order:
    - C:\...\Driveline_CMotionFiles\Filter.v3s
    - C:\...\Driveline_CMotionFiles\Events.v3s
    - C:\...\openbiomechanics-main\baseball_pitching\code\v3d\CMO.v3s \\{{ :sift:tutorials:openbiomechanics_project:buildingcmzspitching_cmzdlg.png }}\\
  - Click **Create CMZs**
    - A metadata dialog box will appear. Ensure the **"Subject_Specific"** next to **"playing_level"** is checked and click "Apply". \\ {{ :pitchingMeta.png }} \\
    - CMZ files may take some time to build. Check the status bar in the bottom left hand corner of the interface for the build status. 
    - After the files are built, check that the Library Path dialog is set correctly and hit "Load" in the **[[:sift:application:Load_Library_Dialog|Load Library]]** dialog.
    - On the [[:sift:application:load_page|Load Page]], you will see all of the workspaces for the pitching data have been created and loaded.

==== Query and Inspect Pitching Data ====

After building CMZs you will need to query your data before you can inspect it. Start by opening the [[:sift:application:query_builder_dialog|Query Builder dialog]] on the [[:sift:application:Explore_page|Explore Page]] and navigating to the [[sift:application:query_builder_dialog#auto_populate_queries|Auto-Populate Query]] menu. Browse for an Auto Build Settings File and populate this field with the **AutoBuilderSettings_Pitch.xml** file found under the c-motion specific files zip folder you downloaded earlier. The dialog should auto-populate with the query refinements.

Click Create, select the groups you want to query, and hit "Calculate Selected Queries".

You should now be able to inspect the data you loaded. An example from this data set is shown below.

{{ sift:tutorials:openbiomechanics_project:collegevsmilbbuildcmz.png?800 }}

===== Further Reading =====

To recap: this tutorial has demonstrated how Sift can be used to streamline the processing of large data sets. It can:

  * automatically combine static, dynamic, and MDH files into CMZs
  * automatically apply metadata to data sets
  * automatically apply refinements to data sets
  * visualize and display the refined data

For examples of how to create and manage metadata files, see: [[Other:Inspect3D:Tutorials:Metadata|Refining Queries with Metadata Tutorial]]