# Bat Tracking Preferences

## **Analysis Preferences**

Bat Tracking operates within Theia’s standard analysis workflow, and the Bat Tracking-specific preferences are located within the main [Settings menu](https://docs.theiamarkerless.com/theia3d-documentation/theia3d-dropdown-menus/settings-menu). These standard preferences should be adjusted to suit the current trial as usual.

<figure><img src="https://1706549236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYh9tF8t29uxjFeOYjlEz%2Fuploads%2FP7xIsf5S8QUeSyVdJwMw%2Funknown.png?alt=media&#x26;token=dd0f4e3c-8de5-417b-bafa-cc1bdd0f8223" alt=""><figcaption><p>The Analysis preferences dialog window, including Object Tracking Parameters.</p></figcaption></figure>

***

### **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](#smoothing-frequency "mention") for additional details.

* **Baseball Bat:** 50 Hz (default)

<figure><img src="https://1706549236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYh9tF8t29uxjFeOYjlEz%2Fuploads%2FbOSkrkOoaB1nYIMK3JVu%2Fimage.png?alt=media&#x26;token=1a8caaa8-ab91-490e-b1bb-bd7e3cb3e7fc" alt=""><figcaption><p>Object Tracking Parameters section of the Analysis preferences pane, showing the Smoothing Frequency slider and gear icon for advanced object definition parameters.</p></figcaption></figure>

#### 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:** 10 Hz (default)
* **Tip:** 60 Hz (default)

<figure><img src="https://1706549236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYh9tF8t29uxjFeOYjlEz%2Fuploads%2FWCa1z7JGOOKeX2sgsBbC%2Fimage.png?alt=media&#x26;token=eb8ce7f8-a953-4819-9e61-3d9819d26623" alt=""><figcaption><p>Advanced Object Definition parameters for further adjusting object tracking and smoothing.</p></figcaption></figure>

***

### **Skeleton Tracking Parameters**

Skeleton tracking runs concurrently with object tracking, skeleton analysis parameters can be found in  [#analysis-preferences](#analysis-preferences "mention").

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.

{% hint style="warning" %}
If the smoothing frequency is set too low when processing very fast movements, tracking dropouts may occur as the fastest moving segments are detected as outliers, or delays may be introduced. If you encounter this situation, try increasing the smoothing frequency and using Solve Skeleton to implement the new setting, which may restore or improve segment tracking.
{% endhint %}

***

## **Rendering Preferences**

<figure><img src="https://1706549236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYh9tF8t29uxjFeOYjlEz%2Fuploads%2FRvMZDortzFHyVPeqmrzr%2Fimage.png?alt=media&#x26;token=cbaf2714-1bd2-4167-98df-d887572b7376" alt=""><figcaption><p>Rendering Preferences pane showing Object Tracking options (Show Object, Object Trace).</p></figcaption></figure>

### **Show Object**<img src="https://1706549236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYh9tF8t29uxjFeOYjlEz%2Fuploads%2FxtnVAUaEfSSjNcGBNy1r%2FBaseball_Bat.png?alt=media&#x26;token=4038e6dc-492f-4758-95dd-8a6e722899c9" alt="" data-size="line">

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.

<figure><img src="https://1706549236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYh9tF8t29uxjFeOYjlEz%2Fuploads%2FWbHkTVBu3ZojhxbyXlV2%2Fimage.png?alt=media&#x26;token=558aeeda-bf1f-44da-a93e-0722d13825d5" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Show Object Enabled" %}

<figure><img src="https://1706549236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYh9tF8t29uxjFeOYjlEz%2Fuploads%2FzAfmSva9tSpw1saaJuyY%2Fimage.png?alt=media&#x26;token=801e45d7-11fa-4cde-ba3a-026b820bf38c" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Show Object Disabled " %}

<figure><img src="https://1706549236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYh9tF8t29uxjFeOYjlEz%2Fuploads%2FBHavRRFS5HkDNmwvUZNg%2Fimage.png?alt=media&#x26;token=bf41e372-82ad-41f4-8975-e5bb002abab1" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### **Object Trace**<img src="https://1706549236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYh9tF8t29uxjFeOYjlEz%2Fuploads%2Fd34sodp2NcX5dHsiid3Y%2FBaseball_Bat_trace.png?alt=media&#x26;token=f9fa18dc-86c2-417b-a222-140447db66ce" alt="" data-size="line">

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.

<div data-full-width="true"><figure><img src="https://1706549236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYh9tF8t29uxjFeOYjlEz%2Fuploads%2FL2bn4kxjBXmAjE3uJPj6%2Fimage.png?alt=media&#x26;token=b51efaa6-f9c9-4974-aeb7-83f010b59b97" alt=""><figcaption></figcaption></figure></div>

{% tabs %}
{% tab title="None" %}

<figure><img src="https://1706549236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYh9tF8t29uxjFeOYjlEz%2Fuploads%2Fx3fNFMVsTwzNb3hyYjnN%2Fimage.png?alt=media&#x26;token=c7b14db8-ef0b-4e34-acc3-3a2003e62b2a" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Sparse" %}

<figure><img src="https://1706549236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYh9tF8t29uxjFeOYjlEz%2Fuploads%2FpDkHOSyYERB94uaLkWvn%2Fimage.png?alt=media&#x26;token=dbb14a8e-0601-4874-b94f-f5d20e70517e" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Full" %}

<figure><img src="https://1706549236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYh9tF8t29uxjFeOYjlEz%2Fuploads%2FVUDGaOo40ADffT84ZANg%2Fimage.png?alt=media&#x26;token=ec27bdf7-fcd3-46a5-960d-ca3c6ce6ed70" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

{% embed url="<https://www.youtube.com/watch?v=ugtacwYWyQk>" %}
