For the complete documentation index, see llms.txt. This page is also available as Markdown.

Settings

Data Path

Currently selected batch analysis root folder.


Settings

The Settings section provides widgets to set up the current batch analysis. The data to be processed must be organized in this single root folder that can contain as many levels of subdirectories as desired to organize the data. However, each branch of the directory must end with a folder containing the data for a single trial. This must be a folder of video data as described in Video Data that also contains the calibration files for the cameras. It is critical that the IDs of the cameras in the calibration file are the same as the IDs of the video file subfolders. The Settings section enables the user to input the batch analysis root directory and the output format that will be generated by the batch analysis.


Output Format


Save Workspace

If selected, a Theia3D workspace is saved for each trial in a folder called inputdirectory_workspace. This folder is in the same location and has the same structure as inputdirectory.


Save JSON

If selected, the pose data for all individuals tracked in each trial will be saved in a folder called inputdirectory_json. This folder is in the same location and has the same structure as intputdirectory.


Save C3D

If selected, the pose C3D files will be saved for each trial in a folder called inputdirectory_c3d. This folder is in the same location and has the same structure as inputdirectory. There is also the option to save Multi person C3Ds.


Save FBX

If selected, the pose FBX files will be saved for each trial in a folder called inputdirectory_fbx. This folder is in the same location and has the same structure as inputdirectory. The coordinate system convention used in the .fbx file can be selected from the dropdown box.


Save 2D Video

If selected, video overlay AVI files will be saved for each trial in a folder called inputdirectory_video. This folder is in the same location and has the same structure as inputdirectory. The saved videos will contain any display options selected (boxes, segments, skeleton, or LCSs) for each camera view added to the Videos to be Saved list. The smooothed verison of the skeleton can be saved based on the cutoff freq selected along with the opacity of the skeletal overlay (Skeleton Alpha).

When Save 2D Video is selected, a visible instance of Theia3D will launch as soon as Run Batch is initiated, so both Theia3D and Theia3D Batch windows will be open. This is normal behaviour when Save Video is enabled.


Save 3D Video

If selected, the 3D view will be saved for each trial in a folder called inputdirectory_video. This folder is in the same location and has the same structure as inputdirectory. The saved videos will contain any display options selected (boxes, segments, skeleton, or LCSs) for each camera view added to the Videos to be Saved list. The smooothed verison of the skeleton can be saved based on the cutoff freq selected along with the opacity of the skeletal overlay (Skeleton Alpha).

When Save 3D Video is selected, a visible instance of Theia3D will launch as soon as Run Batch is initiated, so both Theia3D and Theia3D Batch windows will be open. This is normal behaviour when Save Video is enabled. The 3D view will be based on the camera locations of the 2D camera views


Use Hierarchical Names

(Only applicable when Save C3D is selected) If selected, the pose C3D files will be created with file names that combine the folder names from the lowest n levels of the batch analysis folder hierarchy, where n is the selected Level dropdown value. For example, if selected and Level=3 for data that is structured as [subject] / [action] / [trial] / [camID], the output files will be named: [subject]_[action]_[trial]_pose_filt_#.c3d.

Note: The batch analysis may encounter errors if the folder structure, calibration file, or preferences are incorrect. These issues may be identified in the Trials list once the root folder has been selected, however the user is urged to read and understand the requirements for these data structures and files prior to running a batch analysis.


Save Results Log

If selected, a CSV log file containing information pertaining to the batch analysis will be saved upon completion of the batch. This file contains details regarding the trials processed, successes, failures, warnings, processing time, etc., and is formatted for easiest viewing in a spreadsheet application.

Last updated

Was this helpful?