# Trials

The Trials list is populated with all valid trials within the selected batch analysis root folder, once a folder has been selected. Above the trials list are the following options:

### **Search**

**‍**Filters trials via string compare and regular expression. Built-in filter options based on trial states can be accessed using the @ symbol, including those shown below.

<figure><img src="/files/oAGJ8yXYPCgIFe3y8rJd" alt=""><figcaption><p>Available filter options in the Search bar using the @ symbol.</p></figcaption></figure>

After searching, the selection box next to ‘Trials’ can be toggled to select or deselct all trials that were returned based on the string search. Helps with batching a subset of the root folder.

***

### **Details**

**S**how trial metadata like assigned calibrations, trial length (# frames), and frame rate (FPS).

<figure><img src="/files/eYMsicZk4MYGgYIitbgI" alt=""><figcaption></figcaption></figure>

Right-clicking on any trial within the Trials list will provide the following options:

<figure><img src="/files/Np6xZ7t6aOcTch9CR7AJ" alt=""><figcaption></figcaption></figure>

*Open into* allows the location of the selected trial data to be opened in Windows Explorer or the command line, as described above in [File Menu](/axiom-v2025/theia3d-documentation/theia3d-dropdown-menus/file-menu.md).

<figure><img src="/files/cItKRUKK4lI66wzv9wqg" alt=""><figcaption></figcaption></figure>

*Reset Analysis Range* will reset the Analysis Frame Range preference to be reset so that the entire trial will be analyzed from the first to last frame of data.

<figure><img src="/files/ZRyyldASo9MG5dL4KQzx" alt=""><figcaption></figcaption></figure>

The Trials list has the following features within each row. Right-click on the Trials list header to enable or disable specific details columns as desired.

<figure><img src="/files/EGS36x2uy3NkDJwHVIT9" alt=""><figcaption></figcaption></figure>

***

#### **Dropdown**  <img src="/files/3jSbHrkaPXa2Cfb8aJi1" alt="" data-size="line">&#x20;

Dropdown triangle icon that expands to show the processing steps for each trial. Indicates success, warnings, or failures for each step where required.

#### **Checkbox**‍ <img src="/files/a6JN4zi6LKlGW6d0zDU4" alt="" data-size="line">

Selection square that indicates whether the trial is included in the batch analysis. Initially, all trials are selected.

#### **Trial Path**

The full path to the trial.

#### **State**

Circle that indicates the status of the trial:

<img src="/files/D5nkBLU8KjwDjsrwEzFy" alt="" data-size="line">Unknown, or not yet analyzed

<img src="/files/LlL6Lt4OA4l2g32sf4dD" alt="" data-size="line">Success

<img src="/files/oWWrUlbdKcD0sY4mL4VK" alt="" data-size="line">Skipped

<img src="/files/eRKxJjAi8n8SErxLdtxF" alt="" data-size="line">Already done

<img src="/files/fVghmSOkbVYqhGt84vJm" alt="" data-size="line">Cancelled

<img src="/files/vCIkF58Lm3LdxhUbw57d" alt="" data-size="line">Warning

<img src="/files/KHcZowh4Lny3wLdJOB8e" alt="" data-size="line">Failed

***

### **Calibration**&#x20;

Icon indicates the status of the calibration file for the trial

<details>

<summary><img src="/files/faZQm9fOHoSEKH7UOmAY" alt="" data-size="line"> valid structure and calibration file</summary>

<figure><img src="/files/rrRPI5hBEMM6p2JiDyMQ" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><img src="/files/43frhkoORcbmPwdqLp5y" alt="" data-size="line">more than one calibration file was found.</summary>

<figure><img src="/files/BtC87aiQ0qzOzdkafn2f" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><img src="/files/PQWuLcnlSYZpCaM9aQpp" alt="" data-size="line"> the trial does not have a calibration file.</summary>

<figure><img src="/files/ouhK1maqNO3jDYpB4eIZ" alt=""><figcaption></figcaption></figure>

</details>

### **Calibration Filename**

Filename for the calibration file assigned to the trial. Allows easy distinction when different calibration files should be used for different movement trials within one batch analysis.

***

### **Preferences**&#x20;

Icon indicates the status of the preferences file for the trial.

<details>

<summary> <img src="/files/wWHNVosyjOuwYmm5gott" alt="" data-size="line">default preferences will be used.</summary>

<figure><img src="/files/40iUqUE9wpY7SiMRi4Fh" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><img src="/files/XPmT3gt7XbqH1QrobGIt" alt="" data-size="line">custom preferences file will be used.</summary>

<figure><img src="/files/QgGLl5rA9co7Guj4P8QN" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><img src="/files/QwK31HxmcCfJ0tV2y8EW" alt="" data-size="line">more than one preferences file was found.</summary>

<figure><img src="/files/k96Xm97anx2DO7KkBLEh" alt=""><figcaption></figcaption></figure>

</details>

### **Preferences Filename**

Filename for the preferences file assigned to the trial. Allows easy distinction when different preferences should be used for different movement trials within one batch analysis.<br>

***

### **# Frames**

Length of the trial, expressed as the number of frames.

<figure><img src="/files/Bcd6jvlyrLnmFHp9dmbw" alt=""><figcaption></figcaption></figure>

### **FPS**

Video frame rate of the trial, expressed as Frames Per Second (FPS).

<figure><img src="/files/Z0xD8G1EP0BIv167xsAQ" alt=""><figcaption></figcaption></figure>

### **Cutoff Freq**

Smoothing Frequency that will be used to analyze the trial as selected in the preference file for the trial, expressed in Hz. See details  in [settings](/axiom-v2025/theia3d-documentation/theia3d-batch/settings.md) for how to edit the preferences file to change the Cutoff Freq.

<figure><img src="/files/nLQCAAwE5uALfbFMh6dJ" alt=""><figcaption></figcaption></figure>

### **Excluded Cameras**

List of cameras that will be excluded when processing the trial, based on the list of excluded cameras in the preferences file.

<figure><img src="/files/AydLM433603kHvtqAdIq" alt=""><figcaption></figcaption></figure>

### **Tracking BBox**

Maximum and minimum 3D corner positions of the tracking bounding box, when applied. Expressed as a set of six values: (min\_X, min\_Y, min\_Z, max\_X, max\_Y, max\_Z), where the minimum corner is located at (origin\_X-length/2, origin\_Y-width/2, origin\_Z-height/2) and the maximum corner is located at (origin\_X+length/2, origin\_Y+width/2, origin\_Z+height/2).

<figure><img src="/files/vO4aSfi0qof8SQ0GQAQZ" alt=""><figcaption></figcaption></figure>

At the bottom of the TMBatch window, the Run Batch button is used to start the batch analysis.&#x20;

<figure><img src="/files/PzL1bRdNkzsftgVuGe1A" alt=""><figcaption></figcaption></figure>

After clicking Run Batch, the TMBatch performs a check to identify trials that have already been analyzed. If it finds any, a dialog is shown offering the user to skip or re-run these trials. This allows data to be added to a directory and that directory to be batch processed again without reprocessing completed trials. Once the batch has started, Theia3D will run in the background a full analysis on each checked trial in the list. After the batch has finished, the results of each trial can be viewed in Theia3D by loading the saved workspace belonging to the trial.

### Display Errors

If any errors occur during processing, selecting display errors will bring all of the errors that occurred during processing intoa new tab below the trials

<figure><img src="/files/dqgQVJCswNxdeUWCZqR4" alt=""><figcaption></figcaption></figure>

### **Reload**&#x20;

If any changes are made to the cablibration file, preferences, or files clicking the reliad icon will update the files and icons

### **Modifying the Trials List**

The Trials list can be easily modified using to include or exclude groups of trials to allow portions of the trial list to be left out of the batch analysis. This can be useful if you are only interested in analyzing specific portions of your data, for example only analyzing one action. The easiest way to make modifications to the Trials list is using the Search bar above the Trials list in combination with the selection box next at the top of the Trials list, which selects or deselects all currently displayed trials. This can be performed to exclude specific subsets of trials, or include specific subsets of trials from the batch analysis.

An example procedure for using this technique for modifying the Trials list is as follows:

1. Ensure all trials are currently selected using the ‘select/deselect all’ box at the top of the Trials list.
2. Use a specific search term in the Search bar to display a subset of trials you wish to exclude.
3. Confirm the currently displayed trials are those that you wish to exclude.
4. Use the ‘select/deselect all’ box at the top of the Trials list to deselect these trials.
5. Clear the Search bar.
6. Confirm that the subset of trials is now deselected within the complete Trials list.

**Note:** The list of trials displayed after using the search bar is not the current batch analysis list, but just a list of the trials from within the batch analysis directory that meet the search criteria.

{% embed url="<https://youtu.be/wGM1NMO-VIw>" %}


---

# 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/trials.md?ask=<question>
```

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.