38 lines
2.1 KiB
Markdown
38 lines
2.1 KiB
Markdown
# Scripts reference
|
|
|
|
## Entry points
|
|
- `predict.py` — **single entrypoint: production service (zero flags) + dev CLI.**
|
|
Combined sack+truck model + repo `src/` modules, shapely zones,
|
|
visual-similarity/Re-ID debounce, SQLite, live-frame publish. Run by
|
|
`karung-counter.service`. Flags: `--source/--env/--config/--model/--model-mode/
|
|
--output-dir/--output-json/--sack-conf/--truck-conf/--box-conf/--box-model/
|
|
--batch-timeout/--max-frames/--no-dashboard/--no-db` (see `predict.py --help`).
|
|
Config: `config.yaml` (canonical) + `.env` (secrets/deployment).
|
|
- `src/main.py` — deprecated shim: prints a pointer to `predict.py`, still runs the
|
|
old v3 loop for backward compat.
|
|
- `archive/` — retired: `predict_new.py` (duo-model state machine),
|
|
`rpo_iki/` (alternate geometric engine + `predict_rpo_iki.py`), `simple_predict.py`
|
|
(minimal CPU demo), `ini.py`, check/merge/test scripts. Not imported anywhere.
|
|
|
|
## Calibration & data tools
|
|
- `archive/get_coordinates.py` / `archive/get_calib_frame.py` — zone calibration
|
|
(`calib_frame.jpg`, `zones.json`); `archive/capture_frame_native.py` — grab
|
|
native frames (`live_frame_native.png`).
|
|
- `extract_random_frames.py` — sample frames for labeling; `archive/check_*.py`
|
|
(`check_20_23`, `check_20_aug`, `check_all_after`) — batch verification passes.
|
|
- `archive/test_bytetrack.py`, `archive/test_track_crash.py` — tracker experiments/crash repro.
|
|
|
|
## DB / ops helpers
|
|
`counter_dashboard.py` (dashboard), `check_jetson_db.py`,
|
|
`archive/backup.py`, `archive/dump_db.py`,
|
|
`archive/migrate_jetson_db.py`, `archive/merge_batches_20_23.py`,
|
|
`archive/merge_batches_28_35.py`, `archive/update_batches.py`,
|
|
`archive/diagnose_truck_jetson.py`, `deploy_to_jetson.py`,
|
|
`export_model.py` / `archive/export_v4.py` (TensorRT export).
|
|
|
|
## Ignored at runtime (`.gitignore`)
|
|
`.env`, `*.db`, state JSONs, `batch_history_folder/`, media (`*.mp4/*.jpg/*.png`),
|
|
`*.engine` (rebuildable via `export_model.py`), venvs, IDE files — so the large
|
|
weights, videos and local DBs in this working tree are intentionally untracked.
|
|
(`models/*.pt`/`*.onnx` ARE tracked so clones are inference-ready.)
|