mirror of
https://github.com/macaodha/batdetect2.git
synced 2026-07-07 21:00:10 +02:00
67aee0b79c
Some checks failed
CI / Checks (push) Has been cancelled
Docs Pages / Build Docs (push) Has been cancelled
CI / Tests (Python ${{ matrix.python-version }}) (3.10) (push) Has been cancelled
CI / Tests (Python ${{ matrix.python-version }}) (3.11) (push) Has been cancelled
CI / Tests (Python ${{ matrix.python-version }}) (3.12) (push) Has been cancelled
Docs Pages / Deploy Docs (push) Has been cancelled
40 lines
1.1 KiB
Markdown
40 lines
1.1 KiB
Markdown
# `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
|
|
|
|
```{eval-rst}
|
|
.. autoclass:: batdetect2.api_v2.BatDetect2API
|
|
```
|
|
|
|
## Related pages
|
|
|
|
- Python tutorial:
|
|
{doc}`../tutorials/integrate-with-a-python-pipeline`
|
|
- Outputs config reference:
|
|
{doc}`configs/outputs/outputs-config`
|
|
- Output formats reference:
|
|
{doc}`configs/outputs/output-formats`
|