Skip to main content

Module tracker

Module tracker 

Source
Expand description

Phase 5 / V5 — bounded multi-object tracker (ByteTrack-class association).

Pure Rust, no training, no Python. Fixed slot table — no heap on the hot path.

§Association (ByteTrack-style two-stage IoU)

  1. High-score detections associate first (iou_thresh).
  2. Low-score detections recover remaining unmatched tracks (low_iou_thresh); they never spawn new tracks.
  3. Unmatched high-score detections birth Tentative tracks.
  4. After min_hits successful associations a track becomes Confirmed.
  5. Unmatched tracks age; Tentative dies faster; Confirmed expires after max_miss.

Overflow: when all slots full, new detections keep track_id = 0 and set FLAG_TRACK_OVERFLOW (deterministic; no eviction of live tracks).

Structs§

BoundedTracker
Bounded ByteTrack-class IoU tracker over a frame sequence.

Enums§

ScoreTier
Detection confidence band for two-stage association.
TrackState
Lifecycle of a resident track slot.

Constants§

DEFAULT_HIGH_SCORE_U16
Default high-score floor (~0.5 in score_u16 units).
DEFAULT_LOW_SCORE_U16
Default low-score floor (~0.1) — band for second-stage recovery only.
DEFAULT_MIN_HITS
Default hits required before Tentative → Confirmed.
FLAG_TRACK_OVERFLOW
Detection flag: track table full; this box was not assigned a track id.
MAX_ASSOC_DETS
Max detections considered per frame (fixed association scratch).
MAX_TRACKS
Maximum simultaneous tracks (caller-visible bound).
NO_TRACK
Sentinel: detection has no matched track slot.

Functions§

associate_greedy_iou
Greedy IoU match for one association pass (high-score or low-score stage).
score_tier_of
Classify a packed detection score into a ByteTrack tier.