mirror of
https://github.com/macaodha/batdetect2.git
synced 2026-07-08 05:10:09 +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
44 lines
1.4 KiB
Markdown
44 lines
1.4 KiB
Markdown
# Interpreting formatted outputs
|
|
|
|
BatDetect2 can write predictions in several output formats.
|
|
|
|
Those formats are different views of the same underlying detections, not
|
|
different model behaviors.
|
|
|
|
## Separate the underlying detection from the serialized file
|
|
|
|
Internally, the current stack works with clip-level detections containing
|
|
geometry, detection score, class scores, and features.
|
|
|
|
Output formatters then serialize those detections in different ways.
|
|
|
|
## Raw outputs are richest
|
|
|
|
The `raw` format preserves the broadest structured view of detections and is a
|
|
good default when you want to inspect or reload predictions later.
|
|
|
|
## Tabular outputs are for analysis convenience
|
|
|
|
The `parquet` format is convenient for data analysis workflows, but the tabular
|
|
representation is only one projection of the underlying detection object.
|
|
|
|
## Legacy-shaped outputs are mainly for compatibility
|
|
|
|
The `batdetect2` formatter writes the older BatDetect2-style JSON shape.
|
|
|
|
Use it when you need compatibility with older downstream tools or workflows.
|
|
|
|
## The meaning does not come from the file extension
|
|
|
|
Do not assume that a `.json`, `.parquet`, or `.nc` file changes what the model
|
|
predicted.
|
|
|
|
It changes how the prediction is packaged and how much detail is retained.
|
|
|
|
## Related pages
|
|
|
|
- Output formats reference:
|
|
{doc}`../reference/configs/outputs/output-formats`
|
|
- Outputs config reference:
|
|
{doc}`../reference/configs/outputs/outputs-config`
|