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.
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
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:
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.
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
Dropdown triangle icon that expands to show the processing steps for each trial. Indicates success, warnings, or failures for each step where required.
Checkbox
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:
Unknown, or not yet analyzed
Success
Skipped
Already done
Cancelled
Warning
Failed
Calibration Indicator
Icon that indicates the status of the calibration file for the trial
valid structure and calibration file
more than one calibration file was found.
the trial does not have a calibration file.
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 Indicator
Icon that indicates the status of the preferences file for the trial.
default preferences will be used.
custom preferences file will be used.
more than one preferences file was found.
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.
# Frames
Length of the trial, expressed as the number of frames.
FPS
Video frame rate of the trial, expressed as Frames Per Second (FPS).
Cutoff Freq
GCVSPL Cutoff Frequency that will be used to analyze the trial as selected in the preference file for the trial, expressed in Hz. See details below for how to edit the preferences file to change the Cutoff Freq.
Excluded Cameras
List of cameras that will be excluded when processing the trial, based on the list of excluded cameras in the preferences file.
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).
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.
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:
- 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.
