Skip to content

Commit 3c2789c

Browse files
committed
docs: add BSG Finnish Birds model to README
Add documentation for the new BSG Finnish Birds v4.4 model: - Model description and specifications - Installation instructions - Reference links and citations - Acknowledgment in references section
1 parent 61f5e9e commit 3c2789c

File tree

1 file changed

+21
-1
lines changed

1 file changed

+21
-1
lines changed

README.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ A fast, cross-platform CLI tool for bird species detection using [BirdNET](https
99

1010
## Features
1111

12-
- **Multiple AI Models**: Support for BirdNET v2.4, BirdNET v3.0, and Google Perch v2 models
12+
- **Multiple AI Models**: Support for BirdNET v2.4, BirdNET v3.0, Google Perch v2, and BSG Finnish Birds models
1313
- **GPU Acceleration**: Optional CUDA support for faster inference on NVIDIA GPUs
1414
- **Species Filtering**: Dynamic range filtering by location/date or static species list files
1515
- **Multiple Output Formats**: CSV, JSON, Raven selection tables, Audacity labels, Kaleidoscope CSV
@@ -529,8 +529,27 @@ birda models install birdnet-v24
529529
- **Sample rate**: 48kHz
530530
- **Segment duration**: 3 seconds
531531
- **Species**: ~6,000 bird species globally
532+
- **Range filtering**: Supported with meta model
532533
- **Source**: [BirdNET-onnx on Hugging Face](https://huggingface.co/justinchuby/BirdNET-onnx) (optimized ONNX conversion by Justin Chu)
533534

535+
### BSG Finnish Birds v4.4
536+
537+
```bash
538+
birda models install bsg-fi-v44
539+
```
540+
541+
- **License**: BSG-NC-1.0 (non-commercial use only, no app stores)
542+
- **Vendor**: University of Jyväskylä
543+
- **Sample rate**: 48kHz
544+
- **Segment duration**: 3 seconds
545+
- **Species**: 263 Finnish bird species (breeders, migrants, vagrants)
546+
- **Architecture**: Fine-tuned BirdNET model with custom classification head
547+
- **Range filtering**: Not supported (regional specialization)
548+
- **Source**: [BSG on Hugging Face](https://huggingface.co/tphakala/BSG)
549+
- **Citation**: Nokelainen et al. (2024) [doi:10.5334/cstp.710](https://doi.org/10.5334/cstp.710)
550+
551+
The BSG model is optimized for bird sound identification in Finland. It uses a BirdNET-based feature extractor combined with a custom classification head trained on Finnish soundscapes, expert-annotated clips from Xeno-canto, and targeted field recordings. Predictions are calibrated per species and filtered by seasonal/geographic plausibility.
552+
534553
### Google Perch v2
535554

536555
```bash
@@ -565,6 +584,7 @@ MIT License - see [LICENSE](LICENSE) for details.
565584
## Acknowledgments
566585

567586
- [BirdNET](https://github.com/birdnet-team/BirdNET-Analyzer) by the K. Lisa Yang Center for Conservation Bioacoustics
587+
- [BSG](https://github.com/luomus/BSG) by the University of Jyväskylä for Finnish bird sound classification
568588
- [Justin Chu](https://github.com/justinchuby) for converting BirdNET TFLite model to optimized ONNX format
569589
- [birdnet-onnx-converter](https://github.com/tphakala/birdnet-onnx-converter) for custom model conversion and optimization
570590
- [Perch](https://github.com/google-research/perch) by Google Research for bioacoustic analysis

0 commit comments

Comments
 (0)