Add audit_stills.py QC tool: measure how many stills in a collection have no detected face

2026-10-18 09:09:03 -04:00
parent 01eb729c2f
commit e8fd716d82
2 changed files with 118 additions and 0 deletions
@@ -76,6 +76,17 @@ context leaks onto the wrong card:
  AGPL-3.0 too. Fine for personal/research dataset building; if this
  ever ships in a product, revisit.

+## QC: auditing an existing collection
+
+`audit_stills.py` runs the same detector over a directory of stills and
+reports how many contain no face at all — e.g. measuring the damage the
+old person-proxy pipeline did:
+
+```bash
+python audit_stills.py -I ~/Documents/image-training-datasets/gabriel-dropout \
+    --gpu 1 --write-report old_run_report.csv
+```
+
 ## Verification

 Run `--preview-dir` and eyeball the `_ann.png` files: every saved frame