# BirdNET Geomodel V3.0.2

Geographic species occurrence model from the [BirdNET](https://birdnet.cornell.edu/) project. Predicts which species are likely at a given location and time of year.

This repository hosts the **ONNX FP16** variant for use by [BirdNET-Go](https://github.com/tphakala/birdnet-go) as an improved range filter for Google Perch v2 and BirdNET v3.0 classifiers.

## Model Details

- **Version**: V3.0.2
- **Species**: 12,012 across 5 animal classes
  - Birds: 11,157
  - Mammals: 1,087
  - Insects: 566
  - Amphibians: 540
  - Reptiles: 11
- **Input**: `[latitude, longitude, week]` as float32 (shape `[1, 3]`)
  - Latitude: [-90, 90]
  - Longitude: [-180, 180]
  - Week: BirdNET 48-week year (1-48, 4 weeks per month)
- **Output**: 12,012 float32 species occurrence scores
- **Format**: ONNX, FP16 precision
- **Size**: 7.1 MB

## Files

| File | Description | Size |
|------|-------------|------|
| `BirdNET+_Geomodel_V3.0.2_Global_12K_FP16.onnx` | Geomodel ONNX FP16 | 7.1 MB |
| `birdnet-geomodel-v3.0-fp16.onnx` | BirdNET Geomodel v3.0 ONNX FP16 (canonical filename) | 7.1 MB |
| `birdnet-geomodel-v3.0-fp32.onnx` | BirdNET Geomodel v3.0 ONNX FP32, genuine full precision. Recommended: lower CPU RAM than FP16 and more accurate. | 14.7 MB |
| `BirdNET+_Geomodel_V3.0.2_Global_12K_Labels.txt` | Species labels (12,012 entries) | 558 KB |
| `taxonomy.csv` | Full taxonomy with 30 languages (13,360 entries) | 8.7 MB |
| `MODEL_LICENSE.txt` | License terms | 1.5 KB |
| `SHA256SUMS` | File integrity checksums | 388 B |

### Labels format

Tab-separated: `species_code`, `scientific_name`, `common_name`

```
1032549	Petaurista albiventer	White-bellied Giant Flying Squirrel
zothaw	Buteo albonotatus	Zone-tailed Hawk
```

Line number corresponds to model output index (line 1 = index 0).

### Taxonomy CSV

35 columns: index, scientific name, common name (English), species code, class, and 30 language-specific common names (German, Spanish, Polish, French, Dutch, Russian, Japanese, Czech, Catalan, Portuguese, Norwegian, Bulgarian, Swedish, Danish, Turkish, Slovak, Serbian, Ukrainian, Chinese, Finnish, and regional variants of Spanish, Portuguese, Croatian, Lithuanian, Farsi, Welsh, Estonian).

## Source

Original model from [birdnet-team/geomodel v3.0.2](https://github.com/birdnet-team/geomodel/releases/tag/v3.0.2).

## License

Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0).

See `MODEL_LICENSE.txt` for full terms including prohibited uses (poaching, military applications).

Attribution: Powered by [BirdNET](https://birdnet.cornell.edu/).

## Citation

If you use this model in publications or presentations, please cite:

> Powered by BirdNET (https://birdnet.cornell.edu/)