Trials
Last updated
Was this helpful?
Theia Axiom - v2025
Last updated
Was this helpful?
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:
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.
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.
Show trial metadata like assigned calibrations, trial length (# frames), and frame rate (FPS).
Right-clicking on any trial within the Trials list will provide the following options:
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.
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.
Dropdown triangle icon that expands to show the processing steps for each trial. Indicates success, warnings, or failures for each step where required.
Selection square that indicates whether the trial is included in the batch analysis. Initially, all trials are selected.
The full path to the trial.
Circle that indicates the status of the trial:
Icon indicates the status of the calibration file for the trial
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.
Icon indicates the status of the preferences file for the trial.
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.
Length of the trial, expressed as the number of frames.
Video frame rate of the trial, expressed as Frames Per Second (FPS).
List of cameras that will be excluded when processing the trial, based on the list of excluded cameras in the preferences file.
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).
At the bottom of the TMBatch window, the Run Batch button is used to start the batch analysis.
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.
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
If any changes are made to the cablibration file, preferences, or files clicking the reliad icon will update the files and icons
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:
Ensure all trials are currently selected using the ‘select/deselect all’ box at the top of the Trials list.
Use a specific search term in the Search bar to display a subset of trials you wish to exclude.
Confirm the currently displayed trials are those that you wish to exclude.
Use the ‘select/deselect all’ box at the top of the Trials list to deselect these trials.
Clear the Search bar.
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.
Open into allows the location of the selected trial data to be opened in Windows Explorer or the command line, as described above in .
Unknown, or not yet analyzed
Success
Skipped
Already done
Cancelled
Warning
Failed
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 for how to edit the preferences file to change the Cutoff Freq.
