From 3263f42ca8d51280ad1cda771e4dd8714fda8e16 Mon Sep 17 00:00:00 2001 From: Holden Salomon Date: Sat, 13 Jun 2026 20:47:15 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20fix=20image=20quality=20troubleshooting?= =?UTF-8?q?=20=E2=80=94=20clearer=20raise=20vs=20lower=20framing?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Each entry now unambiguously describes the symptom and the direction: - Split each threshold into two entries (problem in each direction) - Eliminate ambiguous 'Face too small' and 'Low confidence detections included' Co-Authored-By: Claude Sonnet 4.6 --- Troubleshooting.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/Troubleshooting.md b/Troubleshooting.md index 62cab54..74b83ec 100644 --- a/Troubleshooting.md +++ b/Troubleshooting.md @@ -161,8 +161,10 @@ Remove this after one run. It deletes winnow-managed Frigate training files for ## Image quality issues -- **Too many blurry images selected**: Raise `BLUR_THRESHOLD` (default `120.0`) — higher values require sharper images; e.g. `200` is stricter -- **Too many images rejected as blurry**: Lower `BLUR_THRESHOLD` — e.g. `80` accepts more blur -- **Face too small**: Lower `MIN_FACE_WIDTH` (default `90px`) -- **Low confidence detections included**: Raise `MIN_CONFIDENCE` (default `0.7`) +- **Selected images are too blurry**: Raise `BLUR_THRESHOLD` (default `120.0`) — e.g. `200` requires sharper images +- **Too many images rejected for blur**: Lower `BLUR_THRESHOLD` — e.g. `80` accepts blurrier images +- **Too many images rejected for small face size**: Lower `MIN_FACE_WIDTH` (default `90`) — e.g. `50` accepts smaller face crops +- **Selected images have poor-quality face crops**: Raise `MIN_FACE_WIDTH` — e.g. `150` requires larger face crops +- **Too many images rejected for low detection confidence**: Lower `MIN_CONFIDENCE` (default `0.7`) — e.g. `0.5` accepts lower-confidence detections +- **Training set includes marginal detections**: Raise `MIN_CONFIDENCE` — e.g. `0.85` requires more confident detections - **Rejected images being re-tried**: Set `RETRY_REJECTED=true` for one run