forked from vnguyen/product-recognition-demo

History

kiyo9w 56cff09292 docs(decision): report the external benchmark on the corrected basis 19 scored rather than 20: sku_l06_1.jpg is now the enrolled l06 view, so it is reported as leaked instead of as a held-out correct accept. 12 correct, 7 abstain, 0 false accepts. Both leak checks are named in the record and in the external README, since the enrollment that closed F-12 is exactly the kind of change that silently converts a held-out row into training data.		2026-09-29 03:30:16 +09:00
..
evaluations/2026-09-29-session	docs(decision): refresh every number the corrected labels moved	2026-09-29 03:18:30 +09:00
external-eval	docs(decision): report the external benchmark on the corrected basis	2026-09-29 03:30:16 +09:00
packshots	fix(catalog): enroll the current l06 package, closing F-12	2026-09-29 03:22:03 +09:00
README.md	Enroll from a repo data dir; read packshots in every orientation	2026-09-29 02:33:47 +09:00

README.md

Recognition data

Everything the identity work needs to be reproducible: sourced packshots, evaluation runs, and the audits that produced them. Nothing here is ephemeral; a run that matters is written here, not to a temp directory.

`packshots/source/`

Front packshots as downloaded, before enrollment. ATTRIBUTION.json records the source URL, the product as printed, and the manufacturer for each. ocr-reads.json holds the OCR text each image produced, so a name/OCR refusal can be re-checked without re-running Vision.

rebuild_catalog.py reads this directory and writes a catalog:

.venv/bin/python code/rebuild_catalog.py --source data/packshots/source \
    --output stock-lopia-clean --csv stock-lopia/stock.csv --min-views 1 --replace

`evaluations/`

One directory per session. Each holds the raw artifacts a claim was computed from, so a number in DECISION.md can be traced back to the run that produced it.

Directory	Contents
`stream/`	WebSocket track dumps from `stream_client.py`, scored by `score_stream.py`.
`still/`	`/v1/recognize` responses for the still-image path.
`catalog-audit/`	`rebuild_catalog.py --json` reports.
`scratch/`	Intermediate images (rotations, crops) kept because they document a finding.

Scoring a stream dump:

.venv/bin/python code/score_stream.py data/evaluations/<session>/stream/<file>.json \
    --labels eval/labels/image6.json --stock-dir stock-lopia-clean