batdetect2/docs/source/how_to/tune-detection-threshold.md

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.

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.