Rewrite docs landing, install, and evaluate pages + fix evaluation distractor filtering#322
Merged
Rewrite docs landing, install, and evaluate pages + fix evaluation distractor filtering#322
Conversation
…docs/rewrite-install-page
* fix(eval): implement MOT Challenge distractor preprocessing in evaluator Add Hungarian-matching distractor removal to _prepare_mot_sequence, matching the MOT Challenge evaluation protocol used by TrackEval. Tracker detections overlapping ignored GT regions (conf==0) are now removed before scoring, so they are neither penalized as FP nor rewarded as TP. * refactor(eval): extract helpers from _prepare_mot_sequence and improve readability Break the monolithic `_prepare_mot_sequence` into focused helper functions: - `_resolve_num_frames` - `_build_id_mappings` - `_extract_ground_truth_frame` - `_extract_tracker_frame` - `_remove_distractor_matches` - `_remap_ids` Replace cryptic abbreviations with descriptive variable names. Add inline TrackEval source references. Remove forbidden module-level docstring. Replace magic numbers with named constants.
Fill in all TODOs in `detection-quality.md` with final prose. Add a Detection Models section with COCmO benchmarks, tabbed single-sequence and all-sequences CLI snippets, and updated results with verified Colab numbers for YOLO26 Nano, RF-DETR Nano, and RF-DETR Medium. Remove YOLOv11 Nano from the guide. Drop the IDSW column from eval commands and output blocks across: - `evaluate.md` - `index.md` - `detection-quality.md` Enable `navigation.footer` in `mkdocs.yml` for Previous/Next page buttons. Align the footer with the page layout via CSS. Update the copyright year to 2026.
…y guide Embed the RF-DETR latency-accuracy chart in the Detection Models section. Add per-detector tracking videos for MOT17-13 below each CLI snippet in Run the Experiment.
…docs/rewrite-install-page
Link the RF-DETR + Trackers live stream video in `index.md` (below Install) and `track.md` (below Install, above Quickstart). Remove BoT-SORT and McByte placeholder rows from the tracking algorithms table in `index.md`.
…eatures Replace outdated evaluation numbers with verified MOT17 FRCNN results. Add: - Download Datasets section - Detection Quality section - Documentation link to trackers.roboflow.com Move the HF Playground section below Algorithms. Remove BoT-SORT and McByte placeholder rows from the algorithms table.
Expand the algorithms table with HOTA scores across four benchmarks: - MOT17 - SportsMOT - SoccerNet - DanceTrack Complete the eval output with all seven MOT17 val sequences using verified numbers. Add: - Dataset table from the download guide - RF-DETR + Trackers YouTube callout - Links to docs pages for install, tracking, evaluation, download, and tracker comparison Move the HF Playground section below Algorithms. Remove BoT-SORT and McByte placeholder rows from the algorithms table.
Move the Algorithms section above Evaluate. Update the algorithms table: - Add a Class column with Python class names - Restore BoT-SORT and McByte as "coming soon" Remove: - Interactive command builder reference - `--output` flag from the download command
Update the algorithms table: - Add a Description column with one-sentence tracker summaries - Move "Coming soon" to the description for BoT-SORT and McByte - Use dashes in metric columns for those rows - Remove the Class column Add a link from "Track from Python" to the documentation. Break the download command into multiple lines for readability.
…docs/rewrite-install-page # Conflicts: # README.md
Update the algorithms table: - Add a Description column with one-sentence tracker summaries - Move "Coming soon" to the description for BoT-SORT and McByte - Use dashes in metric columns for those rows - Remove the Class column Add a link from "Track from Python" to the documentation. Break the download command into multiple lines for readability.
…docs/rewrite-install-page # Conflicts: # README.md
Update the algorithms table: - Add a Description column with one-sentence tracker summaries - Move "Coming soon" to the description for BoT-SORT and McByte - Use dashes in metric columns for those rows - Remove the Class column Add a link from "Track from Python" to the documentation. Break the download command into multiple lines for readability.
…docs/rewrite-install-page
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
index.md,install.md, andevaluate.mdto follow the patterns established intrack.mdanddownload.md— concise prose, CLI-first examples, real benchmark output, and consistent section structure._prepare_mot_sequencewhere ground-truth entries withconf=0(distractors) were not filtered, causing artificially low evaluation scores on MOT17. Also filter tracker entries withid < 0. Results now match TrackEval exactly.--sourceoptional intrackers trackwhen--detectionsis provided and no visual output is requested, enabling frameless tracking for evaluation workflows.