Object Tracking Preferences

Analysis Preferences

Bat Tracking operates within Theia’s standard analysis workflow, and the Object Tracking-specific preferences are located within the main Settings menu. These standard preferences should be adjusted to suit the current trial as usual.


Object Tracking Parameters

Object tracking settings control how Theia tracks objects such as the baseball bat. The available trackable objects depend on your active license options.

Smoothing Frequency

Adjusts the filter cutoff frequency applied to tracked objects. The same filtering method that is applied to the segments of tracked people is used to smooth the bat object movement. See Smoothing Frequency for additional details.

  • Baseball Bat: Linked Object 50 Hz (default)

  • Baseball Ball: Free Object 100Hz (default)

Advanced Object Definition

These parameters are accessible via the gear icon, and allow finer control of keypoint-specific filtering. The 3D trajectories of the listed keypoints are filtered using a lowpass filter with the selected cutoff frequency.

  • Base: 20 Hz (default)

  • Tip: 60 Hz (default)

Advanced Object Definition parameters for further adjusting object tracking and smoothing.

Skeleton Tracking Parameters

Skeleton tracking runs concurrently with object tracking, skeleton analysis parameters can be found in Analysis Preferences.

Ensure the Skeleton Tracking Smoothing Frequency is set appropriately to avoid over-smoothing the data. A smoothing frequency in the range of 15–30 Hz or above is typically adequate to maintain accurate and stable tracking of athletes during bat swings.


Rendering Preferences

Rendering Preferences pane showing Object Tracking options (Show Object, Object Trace).

Show Object

When enabled, tracked objects are rendered in both 2D camera views and the 3D viewer. Objects appear as reprojections in the 2D view and as 3D meshes in the scene window.

Object Traces

Controls how tracked object trajectories are displayed:

  • None (default): No traces are shown.

  • Sparse: Displays individual points (e.g., one per frame).

  • Full: Displays continuous trajectories connecting all frames, visualizing the bat’s complete motion path.

Last updated

Was this helpful?