Instructions to use brunoasm/Cicindela_Platydracus_ID_FMNH with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- fastai
How to use brunoasm/Cicindela_Platydracus_ID_FMNH with fastai:
from huggingface_hub import from_pretrained_fastai learn = from_pretrained_fastai("brunoasm/Cicindela_Platydracus_ID_FMNH") - Notebooks
- Google Colab
- Kaggle
Cicindela + Platydracus Taxonomic Classifier
A multilabel deep-learning model that jointly identifies Cicindela tiger beetles (Cicindelidae) and Platydracus rove beetles (Staphylinidae) from images of pinned museum specimens. The model predicts a hierarchical label set covering genus, species group (Platydracus only), species, and subspecies simultaneously.
Model Details
Built on EVA-02 Large (448 px) from timm with a shared backbone and three classification heads:
- Genus head (softmax, 2 classes): routes inference to the appropriate genus-specific head.
- Cicindela head (sigmoid, 248 classes): species and subspecies labels for Cicindela.
- Platydracus head (sigmoid, 77 classes): species group, species, and subspecies labels for Platydracus.
Training used single-label pretraining followed by multi-label fine-tuning with AsymmetricLoss and square-root inverse-frequency weighted sampling. Mixed precision (fp16) on 2 GPUs.
- Developed by: Bruno A. S. de Medeiros, Negaunee Assistant Curator of Pollinating Insects, Field Museum
- Model type: Multi-head image classification
- License: Apache 2.0
- Base model: eva02_large_patch14_448.mim_m38m_ft_in22k_in1k
- Training code: de-Medeiros-insect-lab/Beetle_taxon_id
Label Vocabulary
327 labels total organized in a four-level hierarchy:
| Level | Count | Rule | Example |
|---|---|---|---|
| Genus | 2 | Capitalized | Cicindela, Platydracus |
| Species group | 14 | Contains group_ |
platydracusgroup_femoratus |
| Species | 201 | One underscore after prefix | cicindela_repanda, platydracus_angusticeps |
| Subspecies | 110 | Two or more underscores | cicindela_repanda_repanda |
Species groups are defined only for Platydracus (14 morphologically diagnosable groups). See vocab.json for the full label list.
Uses
Direct Use
Identification of pinned Cicindela and Platydracus specimens from drawer-scan images generated by DrawerDissect. See the citation below for full dataset and method details.
Out-of-Scope Use
- Species not represented in the FMNH collection.
- Non-pinned or live specimens.
- Other beetle genera.
Evaluation
Metrics on the held-out test set (specimen-weighted, excluding genus-level labels):
| Genus | Level | Terms | Specimens | Precision | Recall | F1 |
|---|---|---|---|---|---|---|
| Cicindela | species | 115 | 829 | 96.8% | 93.7% | 95.2% |
| Cicindela | subspecies | 80 | 468 | 87.1% | 82.5% | 84.7% |
| Cicindela | overall | 195 | 1297 | 93.3% | 89.7% | 91.5% |
| Platydracus | species group | 14 | 230 | 98.7% | 96.1% | 97.4% |
| Platydracus | species | 59 | 230 | 91.4% | 88.3% | 89.8% |
| Platydracus | subspecies | 3 | 30 | 100.0% | 90.0% | 94.7% |
| Platydracus | overall | 76 | 490 | 95.3% | 92.0% | 93.7% |
| All | overall | 271 | 1787 | 93.9% | 90.3% | 92.1% |
Usage
Load the FastAI learner directly (requires the same fastai environment and the MultiHeadBeetleModel class from the training notebook):
from huggingface_hub import from_pretrained_fastai
learn = from_pretrained_fastai("brunoasm/Cicindela_Platydracus_ID_FMNH")
Inference follows standard fastai conventions. The genus head routes each specimen to the appropriate species-level head automatically.
Training Data
Images of pinned museum specimens generated using DrawerDissect on Field Museum collections. See the citation for details.
Citation
Postema, E. G., Briscoe, L., Harder, C., Hancock, G. R. A., Guarnieri, L. D., Eisel, T., Welch, K., Fischer, N., Johnson, C., de Souza, D., Phillip, D., Baquiran, R., Sepulveda, T., & de Medeiros, B. A. S. (2025). DrawerDissect: Whole-drawer insect imaging, segmentation, and transcription using AI. EcoEvoRxiv. https://doi.org/10.32942/X2QW84
Model Card Author
Bruno de Medeiros, Negaunee Assistant Curator of Pollinating Insects, Field Museum
- Downloads last month
- 5