Using Object Tracking

Prerequisites

The following are requirements for Theia Bat Tracking:

  • Valid Theia3D license

  • Theia3D v2026.1.0 or later

  • Theia Baseball Module license add-on

Enable Object Tracking Feature

To use the Object Tracking feature, it must be enabled during startup of Theia3D or Theia3D Batch:

  1. Open Theia3D or Theia3D Batch. When the startup window appears, click Object Tracking.

  2. In the Object Tracking tab, select Enable Linked Object Tracking (beta) to track baseball bats and/or select Enable Free Object Tracking (beta) to track baseballs.

  3. Click OK to launch Theia3D with Bat and/or Ball Tracking enabled. The object tracking engines will be built the first time that these features are enabled during launch.

Theia3D startup window showing the Object tracking option.

Processing Data

Once Theia3D or Theia3D Batch have been launched with the desired Track Linked Object or Track Free Object option enabled, processing markerless data to obtain athlete and object kinematics is no different than processing other movement data in Theia3D.

Once the videos have been organized and the calibration file assigned, the following typical steps can be followed:

In Theia3D:

  1. Load the formatted video data.

  2. Load the calibration file corresponding to the video data.

  3. Adjust the preferences as desired. (Preferences specific to Object Tracking can be found in the following section, Object Tracking Preferences.)

  4. Use the Run Analysis button to process the movement trial.

In Theia3D Batch:

  1. Select the batch directory.

  2. Select the desired output format(s).

  3. Adjust the preferences as desired, for all trials. (Preferences specific to Object Tracking can be found in the following section, Object Tracking Preferences.)

  4. Use the Run Batch button to begin the batch analysis.

Display

The Object and Object Traces can also be shown or hidden in both the 2D and 3D views from the Display menu.

Quick Tools Tab

The Object and Object Traces can also be shown or hidden in both the 2D and 3D views from the 3. Quick ToolsTab

Linked Objects Tracking Icon

Linked Objects Trace Tracking Icon

Free Objects Tracking Icon

Free Objects Trace Tracking Icon

Last updated

Was this helpful?