arcsort 0.1.0__tar.gz

arcsort-0.1.0/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

arcsort-0.1.0/NOTICE

@@ -0,0 +1,17 @@
+ARC-SORT
+Copyright 2026 Athlitix (Girish Kumar Adari)
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+This product includes software developed by third parties; see
+THIRD_PARTY_NOTICES.md for the complete list and license texts/pointers.

arcsort-0.1.0/PKG-INFO

@@ -0,0 +1,301 @@
+Metadata-Version: 2.4
+Name: arcsort
+Version: 0.1.0
+Summary: ARC-SORT: uncertainty-adaptive multi-object tracking for fast motion under moving cameras
+Author-email: Girish Kumar Adari <girish@athlitix.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://athlitix.github.io/arcsort/
+Project-URL: Repository, https://github.com/Athlitix/arcsort
+Project-URL: Paper, https://arxiv.org/abs/2610.22306
+Keywords: multi-object tracking,MOT,sports,kalman filter,IMM,SORT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Scientific/Engineering :: Image Recognition
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+License-File: THIRD_PARTY_NOTICES.md
+Requires-Dist: numpy>=1.24
+Requires-Dist: scipy>=1.10
+Requires-Dist: opencv-python>=4.8
+Requires-Dist: lap>=0.5.12
+Requires-Dist: loguru>=0.7
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: reid
+Requires-Dist: torch>=2.1; extra == "reid"
+Provides-Extra: viz
+Requires-Dist: supervision>=0.20; extra == "viz"
+Provides-Extra: eval
+Requires-Dist: tqdm; extra == "eval"
+Provides-Extra: yolo
+Requires-Dist: ultralytics>=8.0; extra == "yolo"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Dynamic: license-file
+
+# ARC-SORT
+
+**Adaptive, Robust, Compensated Multi-Object Tracking with Interacting Multiple Models**
+
+[![arXiv](https://img.shields.io/badge/arXiv-2610.22306-b31b1b.svg)](https://arxiv.org/abs/2610.22306)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://github.com/Athlitix/arcsort/blob/main/LICENSE)
+[![Project page](https://img.shields.io/badge/project-page-1f4fd8.svg)](https://athlitix.github.io/arcsort/)
+[![PyPI](https://img.shields.io/pypi/v/arcsort.svg)](https://pypi.org/project/arcsort/)
+
+ARC-SORT is a tracking-by-detection multi-object tracker for fast, non-linear motion under a
+moving camera, such as athletes in sports broadcasts. Nothing is trained. It works with any detector and
+runs at about 50 FPS on a laptop RTX 3060.
+
+The idea: **the tracker measures its own uncertainty, and that measurement decides how it acts.**
+
+- **IMM Kalman filter** (constant velocity / constant acceleration / coordinated turn) gives each
+  track a predictive covariance.
+- **Uncertainty-adaptive Expansion IoU**: the less reliable a track's motion prediction, the larger
+  the region in which a detection may match it.
+- **Deferred identity arbitration**: when two tracks cross and the assignment was a close call,
+  the pair stays under review; at most one corrective identity swap is applied once post-crossing
+  appearance evidence shows the first decision was wrong.
+- **Camera-motion compensation**, BYTE two-stage matching, OC-SORT observation-centric recovery,
+  and appearance (ReID) costs.
+- **Offline tracklet merge** that links players who leave the frame by appearance alone (no
+  motion gate, since extrapolating motion over seconds off-screen carries no information).
+
+## Results
+
+Test-set numbers are from the official evaluation servers (CodaBench).
+
+| Benchmark (test) | HOTA | AssA | DetA | MOTA | IDF1 | IDs |
+|---|---|---|---|---|---|---|
+| SportsMOT | **81.82** | 76.24 | 87.84 | 97.09 | 88.47 | 1414 |
+| SportsMOT, Deep-EIoU's detections + embeddings | 80.31 | 74.14 | 87.04 | 96.65 | 86.92 | 1320 |
+| DanceTrack | **62.1** | 48.2 | 80.3 | 92.4 | 66.5 | — |
+
+As of August 2026, SportsMOT has the fewest identity switches of all 69 leaderboard entries.
+On Deep-EIoU's own inputs, ARC-SORT is +3.1 HOTA over Deep-EIoU (77.2).
+
+Validation numbers, reproducible locally (pooled TrackEval):
+
+| Benchmark (val) | HOTA | AssA | IDF1 |
+|---|---|---|---|
+| SportsMOT | 84.96 | 82.96 | 92.79 |
+| DanceTrack | 60.62 | 47.44 | 64.80 |
+
+## Installation
+
+Python 3.10+ (developed on 3.12).
+
+```bash
+git clone https://github.com/Athlitix/arcsort.git && cd arcsort
+pip install -e ".[reid,eval]"
+```
+
+For the GPU stages (detection, embeddings), install a CUDA build of PyTorch first; see
+[pytorch.org](https://pytorch.org/get-started/locally/). Tracking from cached inputs runs on CPU.
+
+External code (clone into `external/`, which is gitignored):
+
+| Repo | Needed for | Command |
+|---|---|---|
+| [TrackEval](https://github.com/JonathonLuiten/TrackEval) | val evaluation | `git clone https://github.com/JonathonLuiten/TrackEval external/TrackEval` |
+| [YOLOX](https://github.com/Megvii-BaseDetection/YOLOX) | regenerating detections | `git clone https://github.com/Megvii-BaseDetection/YOLOX external/YOLOX` |
+| [Deep-OC-SORT](https://github.com/GerardMaggiolino/Deep-OC-SORT) | converting DanceTrack ReID weights (bundles FastReID) | `git clone https://github.com/GerardMaggiolino/Deep-OC-SORT external/Deep-OC-SORT` |
+
+## Quick start: track with any detector
+
+ARC-SORT takes boxes and scores from any detector and returns boxes with persistent IDs:
+
+```python
+from arcsort import ARCTracker
+
+tracker = ARCTracker.from_preset("sportsmot")       # motion-only, runs on CPU
+# tracker = ARCTracker.from_preset("sportsmot", reid_weights="weights/sportsmot/sports_osnet_traced.pt")
+
+for frame in video:                                   # BGR numpy image
+    dets = my_detector(frame)                         # (N, 6): x1, y1, x2, y2, score, class_id
+    tracks = tracker.update(dets, frame)              # (M, 5): x1, y1, x2, y2, track_id
+```
+
+- **Presets**: `sportsmot` (recommended default for sports footage), `dancetrack`, and
+  `sportsmot_deepeiou_inputs`. Override any key, e.g.
+  `ARCTracker.from_preset("sportsmot", track_buffer=60, eiou={"adaptive_scale": 3.0})`.
+- **`frame`** is used for camera-motion compensation and ReID crops. Pass it every frame
+  (or `use_cmc=False` for a static camera).
+- **ReID** needs the `reid` extra, a CUDA GPU and converted weights (see [Weights](#weights)).
+  Without it the tracker runs motion-only.
+- **Score thresholds**: the defaults (`track_high_thresh` 0.6, `new_track_thresh` 0.7) worked
+  best for every detector we tested. Lowering them reduced HOTA for ARC-SORT and for the
+  baselines alike. Run the detector itself with a low confidence floor (e.g. 0.05) so that BYTE's
+  second stage sees low-score boxes.
+- **supervision** users: `arcsort.interop.from_supervision(detections)` and
+  `to_supervision(tracks)` convert to and from `sv.Detections` (`pip install arcsort[viz]`).
+- Start a new video with `tracker.reset()`. Several trackers can run in one process (e.g. one per
+  camera); each numbers its own tracks.
+
+A detector factory is included for common backends (`pip install arcsort[yolo]` for Ultralytics;
+RF-DETR and transformers are installed separately):
+
+```python
+from arcsort.detection import create_detector
+
+detector = create_detector("yolo11x.pt", imgsz=1280, conf_thresh=0.05, classes=[0])
+# also: "rfdetr-large", "PekingU/rtdetr_v2_r101vd", "rtdetr-x.pt" (use imgsz=640), YOLOX
+dets = detector.detect(frame)    # (N, 6), class ids in COCO-80 order (person = 0)
+```
+
+### Tested detectors
+
+ARC-SORT was run unchanged (`from_preset("sportsmot")` with live ReID and CMC) behind the
+detectors below. The test used three SportsMOT validation clips (basketball, football, volleyball;
+1,616 frames). Every tracker got identical detections. Baselines are the Roboflow
+[`trackers`](https://github.com/roboflow/trackers) implementations with default settings.
+
+| Detector | Library | ByteTrack | BoT-SORT | ARC-SORT online | ARC-SORT + offline merge |
+|---|---|---|---|---|---|
+| YOLOv8x | Ultralytics | 57.0 | 59.4 | **62.2** | **66.2** |
+| YOLOv10x | Ultralytics | 61.8 | **63.9** | 61.6 | **65.0** |
+| YOLO11x | Ultralytics | 57.5 | **60.3** | 58.6 | **62.6** |
+| YOLO12x | Ultralytics | 56.7 | 59.8 | **60.9** | **65.7** |
+| YOLO26x | Ultralytics | 57.0 | 57.0 | **59.8** | **64.3** |
+| YOLOv13x | [iMoonLab fork](https://github.com/iMoonLab/yolov13) | 57.2 | 58.6 | **60.2** | **61.5** |
+| RT-DETRv2-R101 | transformers | 57.9 | 58.7 | **59.8** | **64.0** |
+| RF-DETR-L | rfdetr | 65.2 | 65.9 | **67.6** | **71.6** |
+| YOLOX-X (SportsMOT-trained) | YOLOX | 77.0 | 78.6 | **81.4** | **84.7** |
+
+HOTA; bold marks the best online and best overall result per row. This is a compatibility check,
+not a benchmark: three clips are too few to rank trackers. COCO detectors also detect referees
+and spectators, who are not labelled in SportsMOT, so their absolute scores are low for every
+tracker. Run Ultralytics RT-DETR at its training size (`imgsz=640`); at 1280 it detects only a
+third of the players.
+
+## Reproducing the paper
+
+One command per row:
+
+```bash
+scripts/reproduce.sh sportsmot val            # prints HOTA 84.957
+scripts/reproduce.sh dancetrack val           # prints HOTA 60.617
+scripts/reproduce.sh sportsmot test           # writes outputs/arcsort_sportsmot_test.zip
+scripts/reproduce.sh dancetrack test          # writes outputs/arcsort_dancetrack_test.zip
+scripts/reproduce.sh sportsmot_deepeiou test  # Deep-EIoU's inputs
+```
+
+Upload test zips to the [SportsMOT](https://www.codabench.org/competitions/13077/) or
+[DanceTrack](https://www.codabench.org/competitions/14885/) CodaBench server.
+
+The script runs five stages and skips any stage whose output already exists:
+
+1. **detections**: YOLOX-X, one file per sequence (GPU)
+2. **camera motion**: one affine transform per frame (CPU)
+3. **embeddings**: ReID features for every detection (GPU)
+4. **tracking**: online tracker → interpolation (gaps ≤ 10 frames) → offline tracklet merge (CPU)
+5. **evaluation** (val) or **packaging** (test)
+
+### Fast path: released caches
+
+The [v0.1.0 release](https://github.com/Athlitix/arcsort/releases/tag/v0.1.0) contains our cached
+detections and camera-motion transforms (`arcsort-v0.1.0-caches.tar.gz`, ~40 MB). Extract it at
+the repository root and stages 1–2 are skipped:
+
+```bash
+tar xzf arcsort-v0.1.0-caches.tar.gz      # creates cache/detections/ and cache/cmc/
+```
+
+```
+cache/
+  detections/{sportsmot,dancetrack}_{val,test}/<seq>.txt
+  cmc/{sportsmot,dancetrack}_{val,test}/<seq>.npy
+  embeddings/{sportsmot,dancetrack}_{val,test}/<seq>.npz   # computed by stage 3 (GPU)
+```
+
+The release also contains the result files we submitted to the evaluation servers
+(`sportsmot_test.zip`, `dancetrack_test.zip`, `sportsmot_deepeiou_test.zip`). Put them in a folder,
+e.g. `reference/`, and check your run against them:
+
+```bash
+scripts/regression_gate.sh cache reference
+```
+
+Detector and ReID outputs can differ in the last bits across GPU models and library versions, and
+a few changed embeddings can flip a few association decisions. On other hardware, expect numbers
+within noise of the paper, not byte-identical files. Our results were produced on an RTX 3060 Laptop
+GPU with torch 2.5.1+cu121, numpy 2.4.3, opencv-python 4.13.0, scipy 1.17.1 and lap 0.5.13. On that
+setup, every stage regenerates byte-identically from the raw upstream downloads.
+
+### Datasets
+
+Download [SportsMOT](https://github.com/MCG-NJU/SportsMOT) and
+[DanceTrack](https://github.com/DanceTrack/DanceTrack) and arrange them in MOTChallenge layout:
+
+```
+data/
+  SportsMOT/{val,test}/<seq>/{img1/,gt/,seqinfo.ini}
+  DanceTrack/{val,test}/<seq>/{img1/,gt/,seqinfo.ini}
+```
+
+Frames are needed for stages 1–3 only. Val evaluation needs `gt/`.
+
+### Weights
+
+Weights are not redistributed here. Download them from the original authors:
+
+| File in `weights/` | Used for | Source |
+|---|---|---|
+| `sportsmot/yolox_x_sports_train.pth.tar` | SportsMOT **val** detections (train-split checkpoint, so no val frame was seen) | [MixSort model zoo](https://github.com/MCG-NJU/MixSort) |
+| `sportsmot/yolox_x_sports_mix.pth.tar` | SportsMOT **test** detections (train+val checkpoint) | [MixSort model zoo](https://github.com/MCG-NJU/MixSort) |
+| `ocsort_dance_model.pth.tar` | DanceTrack detections | [OC-SORT model zoo](https://github.com/noahcao/OC_SORT) |
+| `sportsmot/sports_osnet_traced.pt` | SportsMOT ReID | converted from Deep-EIoU's `sports_model.pth.tar-60` ([Deep-EIoU](https://github.com/hsiangwei0903/Deep-EIoU)), see below |
+| `dance_sbs_S50_traced.pt` | DanceTrack ReID | converted from FastReID `dance_sbs_S50.pth` ([Deep-OC-SORT](https://github.com/GerardMaggiolino/Deep-OC-SORT)), see below |
+
+ReID conversion to TorchScript (one-time, needs a CUDA GPU):
+
+```bash
+# SportsMOT: sports-domain OSNet from Deep-EIoU
+python tools/extract_state_dict.py --input sports_model.pth.tar-60 \
+    --output weights/sportsmot/sports_osnet_clean.pth
+python tools/convert_osnet_weights.py --input weights/sportsmot/sports_osnet_clean.pth \
+    --output weights/sportsmot/sports_osnet_traced.pt
+
+# DanceTrack: FastReID SBS-S50 (needs external/Deep-OC-SORT)
+python tools/convert_reid_weights.py --input dance_sbs_S50.pth \
+    --output weights/dance_sbs_S50_traced.pt --config dancetrack
+```
+
+`extract_state_dict.py` loads the training checkpoint with `weights_only=False`, so only run it
+on files from the official release.
+
+For the Deep-EIoU-inputs row, download Deep-EIoU's released SportsMOT test detections and
+embeddings into `external/Deep-EIoU/{detection,embedding}/` (or set `DEEP_EIOU_ASSETS`).
+
+## Repository layout
+
+```
+arcsort/          tracker package (IMM-KF, EIoU, CMC, ReID, arbitration, OC-SORT components)
+arcsort/configs/  presets = the exact configurations behind each paper row
+configs/detector/ YOLOX experiment files
+tools/            caching, tracking, post-processing, evaluation, FPS benchmark, video demo
+scripts/          reproduce.sh, regression_gate.sh
+tests/            unit tests (pytest)
+third_party/      vendored OSNet architecture (MIT)
+docs/             project page (GitHub Pages)
+```
+
+## Citation
+
+```bibtex
+@article{adari2026arcsort,
+  title   = {{ARC-SORT}: Adaptive, Robust, Compensated Multi-Object Tracking with Interacting Multiple Models},
+  author  = {Adari, Girish Kumar},
+  journal = {arXiv preprint arXiv:2610.22306},
+  year    = {2026}
+}
+```
+
+## License
+
+Apache License 2.0; see [LICENSE](https://github.com/Athlitix/arcsort/blob/main/LICENSE) and [NOTICE](https://github.com/Athlitix/arcsort/blob/main/NOTICE). ARC-SORT builds on OC-SORT,
+ByteTrack, BoT-SORT and Deep OC-SORT; see [THIRD_PARTY_NOTICES.md](https://github.com/Athlitix/arcsort/blob/main/THIRD_PARTY_NOTICES.md).
+Pretrained weights and datasets are subject to their own licenses and terms, which may restrict
+commercial use independently of this code's license.