chriamue commited on
Commit
64786fd
1 Parent(s): ff51362

adds model card

Browse files
Files changed (1) hide show
  1. README.md +59 -1
README.md CHANGED
@@ -12,4 +12,62 @@ tags:
12
  - biology
13
  - image-classification
14
  - vision
15
- ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
12
  - biology
13
  - image-classification
14
  - vision
15
+ ---
16
+
17
+ # Model Card for "Bird Species Classifier"
18
+
19
+ ## Model Description
20
+ The "Bird Species Classifier" is a state-of-the-art image classification model designed to identify various bird species from images. It uses the EfficientNet architecture and has been fine-tuned to achieve high accuracy in recognizing a wide range of bird species.
21
+
22
+ ### How to Use
23
+ You can easily use the model in your Python environment with the following code:
24
+
25
+ ```python
26
+ from transformers import AutoFeatureExtractor, AutoModelForImageClassification
27
+
28
+ extractor = AutoFeatureExtractor.from_pretrained("chriamue/bird-species-classifier")
29
+ model = AutoModelForImageClassification.from_pretrained("chriamue/bird-species-classifier")
30
+ ```
31
+
32
+ ### Applications
33
+ - Bird species identification for educational or ecological research.
34
+ - Assistance in biodiversity monitoring and conservation efforts.
35
+ - Enhancing user experience in nature apps and platforms.
36
+
37
+ ## Training Data
38
+ The model was trained on the "Bird Species" dataset, which is a comprehensive collection of bird images. Key features of this dataset include:
39
+
40
+ - **Total Species**: 525 bird species.
41
+ - **Training Images**: 84,635 images.
42
+ - **Validation Images**: 2,625 images.
43
+ - **Test Images**: 2,625 images.
44
+ - **Image Format**: Color images (224x224x3) in JPG format.
45
+ - **Source**: Sourced from Kaggle.
46
+
47
+ ## Training Results
48
+ The model achieved impressive results after 6 epochs of training:
49
+
50
+ - **Accuracy**: 96.8%
51
+ - **Loss**: 0.1379
52
+ - **Runtime**: 136.81 seconds
53
+ - **Samples per Second**: 19.188
54
+ - **Steps per Second**: 1.206
55
+ - **Total Training Steps**: 31,740
56
+
57
+ These metrics indicate a high level of performance, making the model reliable for practical applications.
58
+
59
+ ## Limitations and Bias
60
+ - The performance of the model might vary under different lighting conditions or image qualities.
61
+ - The model's accuracy is dependent on the diversity and representation in the training dataset. It may perform less effectively on bird species not well represented in the dataset.
62
+
63
+ ## Ethical Considerations
64
+ This model should be used responsibly, considering privacy and environmental impacts. It should not be used for harmful purposes such as targeting endangered species or violating wildlife protection laws.
65
+
66
+ ## Acknowledgements
67
+ We would like to acknowledge the creators of the dataset on Kaggle for providing a rich source of data that made this model possible.
68
+
69
+ ## See also
70
+
71
+ - [Bird Species Dataset](https://huggingface.co/datasets/chriamue/bird-species-dataset)
72
+ - [Kaggle Dataset](https://www.kaggle.com/datasets/gpiosenka/100-bird-species/data)
73
+ - [Bird Species Classifier](https://huggingface.co/dennisjooo/Birds-Classifier-EfficientNetB2)