tphakala commited on
Commit
c18512e
·
verified ·
1 Parent(s): 792f91d

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +6 -2
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
- | `BSG_birds_Finland_v4_4_fp32.onnx` | Full precision (FP32) | GPU (CUDA/TensorRT), Desktop CPU |
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