BoxMOT Files

This major release completes oriented-box support across the Python tracker set, introduces reproducible experiment catalogs, improves native/Python parity, and substantially expands ReID training and deployment.

Highlights

• All registered Python trackers now support canonical AABB and OBB inputs and outputs.
• Added oriented association, angle-continuous motion updates, OBB-aware CMC and ReID crops, and row-aligned masks.
• Replaced monolithic benchmark configs with validated datasets, detectors, ReID profiles, artifacts, presets, and composable experiments.
• Experiment runs now preserve both authored and fully resolved configurations.
• MOT evaluation now parallelizes sequences and adds IDt, IDa, and IDm diagnostics.
• Added optional TrackEval comparison through --compare-trackeval and the trackeval extra.
• Hardened native AABB/OBB replay, CMC, fixed-batch ReID, cache identity, and Python/C++ metric parity.
• Expanded CSL-TinyViT, MobileNetV4, and Hi-AFA training, including privileged anatomical supervision, advanced augmentation, provenance checks, and reliable resume support.
• Added compare-reid for cross-domain checkpoint evaluation.
• Added native Core ML FP16 export and inference with configurable static batch buckets.
• Reduced tracker startup and CMC overhead, exposed setup timings, and added saved-video FPS control.
• Versioned embedding caches by producer, runtime, model fingerprint, preprocessing policy, and crop schema.

Breaking Changes and Migration

Recommended evaluation commands:

:::bash
boxmot eval --experiment mot17-ablation-yolox-lmbn --tracker boosttrack
boxmot eval --dataset mot17 --split ablation --tracker boosttrack

The stable public imports remain:

:::python
from boxmot import BoxMOT, Detector, ReIDModel

Additional migration notes:

• Custom trackers must implement _track_detections() instead of _update_impl().
• Detection and result validation is stricter; empty arrays must retain their canonical column shape.
• TrackResults.xyxy returns the enclosing AABB in OBB mode. Use .boxes or .xywha for oriented geometry.
• Legacy embedding caches may be regenerated when their producer, model, runtime, or crop semantics cannot be verified.
• Finite file and directory sources are consumed before BoxMOT.track() returns. Use boxmot.api.functional.track() when lazy finite-source iteration is required.

What’s Changed

• Complete OBB support for the remaining trackers
• ReID, tracker, configuration, native backend, and metrics refactor
• Benchmark documentation cleanup

Full Changelog: v22.0.0...v23.0.0

Contributors

• @mikel-brostrom