Update README.md
Browse files
README.md
CHANGED
|
@@ -15,22 +15,26 @@ tags:
|
|
| 15 |
|
| 16 |
Optimized [ONNX](https://onnx.ai/) conversions of the **BSG – Finnish Birds Model**, a pretrained bird sound classification model fine-tuned for Finland. The original model was developed at the **University of Jyväskylä** and is based on the [BirdNET](https://github.com/kahst/BirdNET-Analyzer) model architecture.
|
| 17 |
|
|
|
|
|
|
|
| 18 |
## Model Description
|
| 19 |
|
| 20 |
The BSG Finnish Birds Model uses an **EfficientNet-B0** backbone (from BirdNET-Analyzer) with a custom classification head trained on vocalizations of **263 Finnish bird species**, covering all breeders, non-breeding migrants, and most common vagrants.
|
| 21 |
|
|
|
|
|
|
|
| 22 |
**Key characteristics:**
|
| 23 |
|
| 24 |
- Processes audio in **3-second overlapping segments** (spectrogram-based)
|
| 25 |
- Outputs species-wise detection probabilities, calibrated per species via logistic regression
|
| 26 |
- Predictions are filtered by species' seasonal and geographic plausibility to reduce misclassifications
|
|
|
|
| 27 |
|
| 28 |
## Files
|
| 29 |
|
| 30 |
| File | Description | Recommended Use |
|
| 31 |
|------|-------------|-----------------|
|
| 32 |
-
| `
|
| 33 |
-
| `BSG_birds_Finland_v4_4_fp16.onnx` | Half precision (FP16) | RPi 5, Modern GPUs |
|
| 34 |
| `BSG_birds_Finland_v4_4_labels_fi.txt` | Labels (Scientific name_Finnish name) | Class index mapping |
|
| 35 |
|
| 36 |
## ONNX Optimization
|
|
|
|
| 15 |
|
| 16 |
Optimized [ONNX](https://onnx.ai/) conversions of the **BSG – Finnish Birds Model**, a pretrained bird sound classification model fine-tuned for Finland. The original model was developed at the **University of Jyväskylä** and is based on the [BirdNET](https://github.com/kahst/BirdNET-Analyzer) model architecture.
|
| 17 |
|
| 18 |
+
These are **fused models** that combine BirdNET's EfficientNet-B0 feature extractor with the BSG classifier head into a single ONNX graph, making them directly compatible with standard BirdNET inference pipelines — no separate feature extraction step required.
|
| 19 |
+
|
| 20 |
## Model Description
|
| 21 |
|
| 22 |
The BSG Finnish Birds Model uses an **EfficientNet-B0** backbone (from BirdNET-Analyzer) with a custom classification head trained on vocalizations of **263 Finnish bird species**, covering all breeders, non-breeding migrants, and most common vagrants.
|
| 23 |
|
| 24 |
+
The original BSG model is distributed as a standalone classifier that expects pre-extracted BirdNET embeddings as input. The fused ONNX models in this repository merge BirdNET's feature extractor and the BSG classifier into a single end-to-end model that accepts raw spectrograms and outputs species predictions — identical to how the standard BirdNET ONNX model operates. This makes the BSG model a **drop-in replacement** for BirdNET in any application that supports custom ONNX models.
|
| 25 |
+
|
| 26 |
**Key characteristics:**
|
| 27 |
|
| 28 |
- Processes audio in **3-second overlapping segments** (spectrogram-based)
|
| 29 |
- Outputs species-wise detection probabilities, calibrated per species via logistic regression
|
| 30 |
- Predictions are filtered by species' seasonal and geographic plausibility to reduce misclassifications
|
| 31 |
+
- Compatible with standard BirdNET inference workflows (same input/output interface)
|
| 32 |
|
| 33 |
## Files
|
| 34 |
|
| 35 |
| File | Description | Recommended Use |
|
| 36 |
|------|-------------|-----------------|
|
| 37 |
+
| `BSG_birds_Finland_v4_4_fused_fp32.onnx` | Full precision (FP32) | GPU (CUDA/TensorRT), Desktop CPU |
|
|
|
|
| 38 |
| `BSG_birds_Finland_v4_4_labels_fi.txt` | Labels (Scientific name_Finnish name) | Class index mapping |
|
| 39 |
|
| 40 |
## ONNX Optimization
|