# Settings
### 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](/axiom-v2025/theia3d-documentation/data-formats/video-data.md) 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:
### **Data Path**
Currently selected batch analysis root folder.
### **Browse**
Select the batch analysis root folder.
### **Save Workspace**
If selected, a [Theia3D workspace](/axiom-v2025/theia3d-documentation/data-formats/theia3d-workspaces.md) 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](/axiom-v2025/theia3d-documentation/data-formats/json-files.md) 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](/axiom-v2025/theia3d-documentation/data-formats/c3d-files.md) 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*.
### **Save FBX**
If selected, the [pose FBX files](/axiom-v2025/theia3d-documentation/data-formats/fbx-files.md) 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 Video**
If selected, [video overlay AVI files](/axiom-v2025/theia3d-documentation/data-formats/video-overlays.md) 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.
{% hint style="info" %}
When Save 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.
{% endhint %}
### **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.
{% hint style="info" %}
**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.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.theiamarkerless.com/axiom-v2025/theia3d-documentation/theia3d-batch/settings.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.