batdetect2/docs/source/reference/api.md
mbsantiago 999dc93d88 docs: improve API and CLI reference docs
Clarify BatDetect2API usage, add examples and NumPy-style docstrings, and tighten CLI help and reference pages for prediction, training, evaluation, and fine-tuning workflows.
2026-05-06 11:19:38 +01:00

1.0 KiB

BatDetect2API reference

BatDetect2API is the main Python entry point for BatDetect2.

Use it when you want to load a model, run prediction, inspect detections, evaluate results, or train from Python.

Defined in batdetect2.api_v2.

Main ways to create it

  • BatDetect2API.from_checkpoint(path, ...)
    • load a trained checkpoint, a bundled checkpoint alias, or a Hugging Face checkpoint.
  • BatDetect2API.from_config(model_config=..., targets_config=..., ...)
    • build a full model stack from config objects.

Common tasks

  • Load a checkpoint and run prediction on one file.
  • Run prediction on many files or clips.
  • Save predictions in one of the supported output formats.
  • Evaluate a model on labelled data.
  • Fine-tune an existing checkpoint on new targets.

Generated reference

.. autoclass:: batdetect2.api_v2.BatDetect2API
  • Python tutorial: {doc}../tutorials/integrate-with-a-python-pipeline
  • Outputs config reference: {doc}outputs-config
  • Output formats reference: {doc}output-formats