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)
- High-score detections associate first (
iou_thresh). - Low-score detections recover remaining unmatched tracks (
low_iou_thresh); they never spawn new tracks. - Unmatched high-score detections birth Tentative tracks.
- After
min_hitssuccessful associations a track becomes Confirmed. - 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§
- Bounded
Tracker - Bounded ByteTrack-class IoU tracker over a frame sequence.
Enums§
- Score
Tier - Detection confidence band for two-stage association.
- Track
State - 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.