batdetect2/docs/source/how_to/tune-detection-threshold.md
2026-03-28 14:26:51 +00:00

34 lines
887 B
Markdown

# How to tune detection threshold
Use this guide to compare detection outputs at different threshold values.
## 1) Start with a baseline run
Run an initial prediction workflow and keep outputs in a dedicated folder.
## 2) Sweep threshold values
Run `predict` multiple times with different thresholds (for example `0.1`,
`0.3`, `0.5`) and compare output counts and quality on the same validation
subset.
```bash
batdetect2 predict directory \
path/to/model.ckpt \
path/to/audio_dir \
path/to/outputs_thr_03 \
--detection-threshold 0.3
```
## 3) Validate against known calls
Use files with trusted annotations or expert review to select a threshold that
fits your project goals.
## 4) Record your chosen setting
Write down the chosen threshold and rationale so analyses are reproducible.
For conceptual trade-offs, see
{doc}`../explanation/model-output-and-validation`.