brunoasm commited on
Commit
f4dd730
·
verified ·
1 Parent(s): b261205

Upload Cicindela multilabel classification model (FastAI)

Browse files
Files changed (3) hide show
  1. README.md +16 -123
  2. model.pkl +3 -0
  3. pyproject.toml +3 -0
README.md CHANGED
@@ -1,139 +1,32 @@
1
  ---
2
- license: apache-2.0
3
- base_model:
4
- - timm/eva02_large_patch14_448.mim_m38m_ft_in22k_in1k
5
- library_name: fastai
6
  tags:
7
- - Coleoptera
8
- - Taxonomy
9
- - Biology
10
- - Cicindelidae
11
  ---
12
 
13
- # Model Card for Model ID
14
 
15
- <!-- Provide a quick summary of what the model is/does. -->
16
 
17
- This model was trained on all specimens of *Cicindela* tiger beetles from the Field Museum. It is a multilabel model able to identify species and subspecies. See the model config file for all labels included and the publication for metrics.
 
18
 
19
- ## Model Details
20
 
21
- This model is based on the pre-trained [eva02_large_patch14_448](https://huggingface.co/timm/eva02_large_patch14_448.mim_m38m_ft_in22k_in1k) from the timm library.
22
 
23
- The training included several tricks to allow multilabel training with an imbalanced dataset, see the publication for details.
24
 
25
 
26
- ### Model Description
27
-
28
- <!-- Provide a longer summary of what this model is. -->
29
-
30
-
31
-
32
- - **Developed by:** Bruno A. S. de Medeiros, Negaunee Assistant Curator of Pollinating Insects, Field Museum.
33
- - **Model type:** Image classification
34
- - **License:** Apache 2.0
35
- - **Finetuned from model [optional]:** [eva02_large_patch14_448](https://huggingface.co/timm/eva02_large_patch14_448.mim_m38m_ft_in22k_in1k)
36
-
37
- ### Model Sources [optional]
38
-
39
- <!-- Provide the basic links for the model. -->
40
-
41
- - **Paper [optional]:** [More Information Needed]
42
-
43
- ## Uses
44
-
45
- <!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. -->
46
-
47
- ### Direct Use
48
-
49
- <!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
50
- Identification of pinned *Cicindela* specimens.
51
-
52
-
53
-
54
- ### Out-of-Scope Use
55
-
56
- <!-- This section addresses misuse, malicious use, and uses that the model will not work well for. -->
57
-
58
- This model will fail to make predictions on species not present in the FMNH collection. It is also unlikely to perform well for specimens that are note pinned.
59
-
60
- ## Bias, Risks, and Limitations
61
-
62
- <!-- This section is meant to convey both technical and sociotechnical limitations. -->
63
-
64
- The model is only expected to perform well for images of pinned tiger beetles.
65
-
66
-
67
- ## Training Details
68
-
69
- ### Training Data
70
-
71
- <!-- This should link to a Dataset Card, perhaps with a short stub of information on what the training data is all about as well as documentation related to data pre-processing or additional filtering. -->
72
-
73
- Data generated by Elizabeth Postema using DrawerDissect on Field Museum specimens, see the publication for details.
74
-
75
- ### Training Procedure
76
-
77
- <!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->
78
-
79
- #### Preprocessing [optional]
80
-
81
- [More Information Needed]
82
-
83
-
84
- #### Training Hyperparameters
85
-
86
- - **Training regime:** fp16 mixed precision
87
-
88
- ## Evaluation
89
-
90
- <!-- This section describes the evaluation protocols and provides the results. -->
91
-
92
- ### Testing Data, Factors & Metrics
93
-
94
- #### Testing Data
95
-
96
- A subset of the specimens was held as a test set. See publication for details
97
-
98
-
99
- #### Metrics
100
-
101
- Metrics in the test set:
102
-
103
- Dataset Overview:
104
- - Total taxa analyzed: 193
105
- - Species: 115 (59.6%)
106
- - Subspecies: 78 (40.4%)
107
-
108
- Performance Summary:
109
-
110
- Species:
111
- - Specimen-weighted precision: 96.8%
112
- - Specimen-weighted recall: 80.9%
113
- - Specimen-weighted precision: 97.0%
114
- - Specimen-weighted recall: 96.4%
115
-
116
- Subspecies:
117
- - Specimen-weighted precision: 89.0%
118
- - Specimen-weighted recall: 66.5%
119
- - Specimen-weighted precision: 85.0%
120
- - Specimen-weighted recall: 89.0%
121
-
122
-
123
-
124
- ## Citation
125
-
126
- <!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->
127
-
128
- **BibTeX:**
129
-
130
- [More Information Needed]
131
 
132
- **APA:**
133
 
134
- [More Information Needed]
135
 
 
 
136
 
137
- ## Model Card Authors
 
138
 
139
- Bruno de Medeiros, Negaunee Assistant Curator of Pollinating Insects, Field Museum
 
 
1
  ---
 
 
 
 
2
  tags:
3
+ - fastai
 
 
 
4
  ---
5
 
6
+ # Amazing!
7
 
8
+ 🥳 Congratulations on hosting your fastai model on the Hugging Face Hub!
9
 
10
+ # Some next steps
11
+ 1. Fill out this model card with more information (see the template below and the [documentation here](https://huggingface.co/docs/hub/model-repos))!
12
 
13
+ 2. Create a demo in Gradio or Streamlit using 🤗 Spaces ([documentation here](https://huggingface.co/docs/hub/spaces)).
14
 
15
+ 3. Join the fastai community on the [Fastai Discord](https://discord.com/invite/YKrxeNn)!
16
 
17
+ Greetings fellow fastlearner 🤝! Don't forget to delete this content from your model card.
18
 
19
 
20
+ ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
21
 
 
22
 
23
+ # Model card
24
 
25
+ ## Model description
26
+ More information needed
27
 
28
+ ## Intended uses & limitations
29
+ More information needed
30
 
31
+ ## Training and evaluation data
32
+ More information needed
model.pkl ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:a8df42b96f136acf66e0148cbdf605656b1e2d80ec326032401128249e211131
3
+ size 1219774982
pyproject.toml ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ [build-system]
2
+ requires = ["setuptools>=40.8.0", "wheel", "python=3.11.11", "fastai=2.8.0", "fastcore=1.8.0"]
3
+ build-backend = "setuptools.build_meta:__legacy__"