# 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](/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.
***
## Output Format
***
### **Save Workspace**
If selected, a [Theia3D workspace](/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](/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](/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*. There is also the option to save Multi person C3Ds.
***
### **Save FBX**
If selected, the [pose FBX files](/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 2D Video**
If selected, [video overlay AVI files](/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. 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).
{% hint style="info" %}
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.
{% endhint %}
***
### **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).
{% hint style="info" %}
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
{% 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 %}
***
### 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.
---
# 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/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.