---
title: "Use object tracking"
canonical: "https://help.vicon.com/space/ShogunLive121/1253212375/Use%20object%20tracking"
format: markdown
---
To use **ObjectTracker**, the first step is to create a prop and enable **ObjectTracker** as described in [Use the ObjectTracker pipeline](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212375/Use+object+tracking#UseObjectTracker).
From here you can apply an** ObjectTracker Preset** or create your own.
The following topics describe how to use object tracking in Shogun Live:
> Macro (toc)
For further details on the ObjectTracker pipeline and the relevant settings for Object Presets, see [Understand object tracking in Shogun Live](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212206).
> Macro (scroll-pagebreak)
> Macro (anchor)
## Use the ObjectTracker pipeline
To use the ObjectTracker pipeline:
1. Create the object in the usual way:
1. In the **3D View**, select the relevant markers.
2. In the **Tracking **panel, in the **Prop** field, enter a name for the object and click **Create**.
2. In the **Tracking** panel, ensure the new prop is selected and in its **Properties**, ensure the Advanced properties are displayed and ensure **Track with ObjectTracker** is selected.
At the top of the **Tracking** panel, an icon is displayed to the right of the object's name, to indicate that object tracking is now being used for this object.
> Macro (scroll-pagebreak)
## Specify settings for optimal object tracking
If you can't see these parameters, at the top of the relevant panel, click Advanced Parameters .
### System panel settings
Towards the top of the **System** tab, under **System Settings**, the following Advanced global parameters that relate to object tracking are displayed:
> 
> Macro (scroll-pagebreak)
> Macro (scroll-tablelayout)
| Setting | Description |
| --- | --- |
| Force Lowest Latency | Some models of Vicon cameras can be forced into a mode to provide the lowest possible latency at the cost of reducing grayscale and centroid throughput. Generally, select this setting only when the ObjectTracking pipeline (ie, low-latency object tracking) is enabled.
However, note that for some large systems with a high number of cameras, this may cause network problems that manifest as cameras appearing to drop out. For more information, see [Use the Force Lowest Latency option](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212375/Use+object+tracking#UseForceLowestLatency).
Default: Cleared |
| Object Tracking Level | Set the camera and processing parameters to the required level of object tracking:
▪️ **Standard**: Basic level involving no camera changes. This is the standard pipeline.
▪️ **Use Grayscale**: Enables object pose jitter reduction using grayscale data. Note that this requires camera to send only grayscale data, which for large camera counts may cause network issues.
▪️ **Object Tracking Only**: As for Use Grayscale and enables lower quality centroid data to further reduce jitter. This is the ObjectTracker pipeline.
Default: Standard |
> ⚠️ **Caution**
> ⚠️
> ⚠️ ▪️ If you are tracking only a single object or a few rigid objects, you may want to reduce the camera delivery latency and instead allow Shogun, rather than the camera, to fit grayscale blobs. In this case, you can select Force Lowest Latency.
> ⚠️
> ⚠️ ▪️ However, if the system contains a significant number of Vantage cameras and/or a lot of markers, we advise you not to select Force Lowest Latency as this can overload the network with grayscale data.
> Macro (scroll-pagebreak)
> Macro (anchor)
**To use the Force Lowest Latency option:**
1. Connect Shogun Live to a system containing Vicon optical cameras that have a DSP, such as Vantage and/or ViperX, with a number of markers scattered throughout the volume.
2. On the **System** panel, ensure the Advanced parameters are displayed .
3. Select **Force Lowest Latency**.
This ensures that any attached cameras with DSPs do not use them.
If you select Force Lowest Latency in a system with a large number or cameras and/or markers, the cameras may overload the network with grayscale data, which can result in HAL error messages in the Log, and cameras appearing to drop out or show as not transmitting data (ie, in the System panel, their icons are gray or flicker to gray).
> Macro (scroll-pagebreak)
To minimize this effect:
- If possible, use 10 GB networking, rather than 1 GB networking.
- On the System panel, check the Object Tracking Level. If possible, set it to standard, rather than Use Grayscale or Object Tracking Only, which forces the cameras to send grayscale data.
- For all cameras, check that their Grayscale Mode (found in the Optical Setup section of the System panel) is NOT set to Only.
Note that the Force Lowest Latency setting is not available if no cameras with DSPs are attached to the system.
> Macro (anchor)
## Create and apply object presets
Object presets enable you to specify the object tracking and smoothing (filtering) properties for selected objects. (Note that these properties override the overall Object Tracking properties that you can set in the **Processing** panel.)
By experimenting with different values for the filtering properties and applying them to an object using a saved object preset, you can evaluate filter performance to ensure the smoothest possible tracking for selected objects.
**To create an object preset:**
1. At the top of the **Tracking** panel, in the Props section, ensure the object whose tracking and/or filtering properties that you want to refine is selected.
2. On the object's **Properties** tab below, ensure the Advanced properties are displayed and on the right of the **Object Preset** field, click **Manage**.
3. In the **Object Presets** dialog, enter a name for the new preset, click **Add** and ensure the new preset is selected.
4. Specify the required settings and close the dialog.
Object presets are saved in the *Subjects.mcp* file (found in *C:\Users\Public\Documents\Vicon\ShogunLive#.#\LastRun\*UserName), or in any exported tracking configuration.
For information on the available settings for an Object Preset, see [Object Preset settings](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212206/Understand+object+tracking+in+Shogun+Live#ObjectPresetSettings).
> Macro (scroll-pagebreak)
**To apply an object preset:**
1. In the **Tracking** panel, ensure that the object to which you want to apply the preset is selected.
2. On the **Properties** tab below, ensure the Advanced properties are displayed and in the **General** section, from the **Object Preset** list, select the required preset.
The tracking and/or filtering properties specified in the preset are applied to the object.
> Macro (scroll-pagebreak)
### Use Object Preset filtering with ObjectTracker pipeline
The **ObjectTracker **pipeline provides the following methods for filtering tracking data:
- **OneEuro **filter is a low pass filter that filters noisy data in real time.
- **MotionPrediction **monitors and applies different motion models to data in real time, ensuring smooth data during predictable movements.
You can use the provided **Object Preset** defaults to start using these denoisers or create and apply your own preset. For information on the available settings for an Object Preset, see [Object Preset settings](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212206/Understand+object+tracking+in+Shogun+Live#ObjectPresetSettings).