Micro SD/Raw Data - Batch Processing to FBX Files (DOC-5047)

This document will take you through the steps of performing the batch processing workflow. Batch Processing allows for the conversion of multiple takes in the raw data format into FBX files.

Requirements:
 

 

Locating your captured data


Local Recording

  1. Find the recordings done within Hand Engine, navigate to Settings → Browse Recordings.




  2. Next, copy the folder location so you can search for it in the batch processing later on. 


    Within each folder, you will find each take.



    And within each take you will find the files as follows: 


    Explanation: 

    • P1: Refers to Performer 1. If you recorded with more than one performer during a take then the files will have the prefix P2, P3, etc.

    • P1FullBody (FBX): full-body FBX as recorded in Hand Engine.

    • P1 (CAL): Calibration file, specific to each glove (L or R).

    • P1 (CSV): Raw data file containing the raw data from each capture, specific to each glove (L or R).

    • P1Meta (JSON): Metadata file for the take, specific to each glove (L or R).

SD Card Recording

  1. If you have captured takes to the SD card in your glove. You will find the same take folder heirachy as above. The only difference is the naming of each data file within each take: 


    Explanation:

    • P1LSD (CSV): Raw data for the Left Glove from SD Card

    • P1MetaSDL (JSON): Metadata file for the Left Glove from SD Card.

    Note: The glove will not store the calibration file, this is obtained from the recording location of Hand Engine. 

Performing Batch Process

Local Data:

1. Open the Batch Processing tool by heading to File → Batch Processing:

2. You will then be presented with the Batch Processing window:

 

3. Click on the text box below Raw File Folder Location and Navigate to the folder where your local recording data is stored (As explained above)

 

The important thing here is that we have the Data file (P1LSD), P1L.cal, and P1Meta in the same folders and they are relevant to that take.

4. Click on the box below Export Location, and select the folder to store your processed FBX Files.

6. Click on Process! You will see that the progress bar will detect how many takes are to be processed (In this example there are 3).

7. Once the process is complete, the Export location folder will open in windows explorer, so you can check your output. There will be an FBX file within each take folder.

 

SD Card Data

  1. This process is much the same as local data, except here you are able to select your Raw File Folder Location as the SD card itself.

    Note:
    If you will be processing Left and Right-Hand data into a full-body FBX, You will want to merge the data from your Left SD card and Right SD card together.
    This can be done by dragging the folder containing all your takes from each SD card into a folder on your PC. The folders of each take within will merge and bring the Left and Right data into one place.
    Your result should look like this within each take folder:

2. Open Batch Processing in Hand Engine:

3. Select your Raw File Folder Location and Export Location.

4. Toggle the “Raw files recorded via SD Card” to Yes
Note: Hand Engine will use the Metadata file from the SD to match the corresponding calibration for processing.

5. Click “Process”. Once complete, the export location folder will automatically open in windows explorer where you can browse your FBX files.

 


Disclaimer, Intellectual Property, and Licensing


Revision Summary:

Revision 

Date 

Notes 

3

2021.11.10

Updated SD Processing section.

2

2021.11.09

Minor changes to wording.

2021.11.09

Initial version