Table of Contents

Class ByteTracker

Namespace
VisioForge.Core.AI.Analytics.Tracking
Assembly
VisioForge.Core.AI.dll

Pure C# implementation of the ByteTrack multi-object tracking algorithm. Performs distinct high-confidence and low-confidence association passes, class-aware matching, and Kalman-filtered state prediction.

public sealed class ByteTracker

Inheritance

Inherited Members

Remarks

This class is not thread-safe. Call VisioForge.Core.AI.Analytics.Tracking.ByteTracker.Update(VisioForge.Core.Types.VideoProcessing.OnnxDetection[]) serially. The tracker assigns VisioForge.Core.Types.VideoProcessing.OnnxDetection.TrackerId to detections passed to VisioForge.Core.AI.Analytics.Tracking.ByteTracker.Update(VisioForge.Core.Types.VideoProcessing.OnnxDetection[]) in place.

Constructors

ByteTracker(ByteTrackerSettings)

Initializes a new instance of the VisioForge.Core.AI.Analytics.Tracking.ByteTracker class.

public ByteTracker(ByteTrackerSettings settings)

Parameters

settings ByteTrackerSettings

The tracker settings. Must not be null.

Exceptions

ArgumentException

The settings are invalid.

Methods

Reset()

Resets the tracker to its initial state. Clears all tracks and restarts IDs from 1.

public void Reset()

TrimRemovedItems()

Trims the internal removed-items list to prevent unbounded memory growth in long-running pipelines. Call periodically or after a large batch of expirations.

public void TrimRemovedItems()

Update(OnnxDetection[])

Processes one frame of detections and returns the tracker update. Assigns VisioForge.Core.Types.VideoProcessing.OnnxDetection.TrackerId to matched detections in place.

public ByteTrackerUpdate Update(OnnxDetection[] detections)

Parameters

detections OnnxDetection[]

The detections for this frame. Null is treated as empty.

Returns

ByteTrackerUpdate

The tracker update result.