Update README.md
Browse files
README.md
CHANGED
@@ -2,23 +2,66 @@
|
|
2 |
library_name: keras
|
3 |
tags:
|
4 |
- Image Classification
|
|
|
|
|
|
|
|
|
5 |
---
|
6 |
|
7 |
-
|
8 |
|
9 |
-
|
10 |
|
11 |
-
|
12 |
|
13 |
-
|
14 |
|
15 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
16 |
|
17 |
-
|
18 |
|
19 |
-
|
|
|
20 |
|
21 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
22 |
|
23 |
The following hyperparameters were used during training:
|
24 |
|
@@ -32,7 +75,28 @@ The following hyperparameters were used during training:
|
|
32 |
| epsilon | 1e-07 |
|
33 |
| centered | False |
|
34 |
| training_precision | float32 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
35 |
|
|
|
36 |
|
37 |
## Model Plot
|
38 |
|
|
|
2 |
library_name: keras
|
3 |
tags:
|
4 |
- Image Classification
|
5 |
+
language:
|
6 |
+
- en
|
7 |
+
metrics:
|
8 |
+
- accuracy
|
9 |
---
|
10 |
|
11 |
+
# cats-vs-dogs
|
12 |
|
13 |
+
## Model Overview
|
14 |
|
15 |
+
The cats-vs-dogs model is a convolutional neural network (CNN) trained on the [Cats vs Dogs dataset](https://www.tensorflow.org/datasets/catalog/cats_vs_dogs), i.e., a large set of images of cats and dogs.
|
16 |
|
17 |
+
### Details
|
18 |
|
19 |
+
- **Size:** 3,453,121 parameters
|
20 |
+
- **Model type:** CNN
|
21 |
+
- **Optimizer:** `RMSprop`
|
22 |
+
- **Number of Epochs:**
|
23 |
+
- **Hardware:** Tesla V4
|
24 |
+
- **Emissions:** Not measured
|
25 |
+
- **Total Energy Consumption:** Not measured
|
26 |
|
27 |
+
### How to Use
|
28 |
|
29 |
+
```python
|
30 |
+
!pip install huggingface_hub["tensorflow"] -q
|
31 |
|
32 |
+
# We are loading our Keras model from the Hub via the `huggingface_hub.from_pretrained_keras`
|
33 |
+
from huggingface_hub import from_pretrained_keras
|
34 |
+
import tensorflow as tf
|
35 |
+
|
36 |
+
model = from_pretrained_keras("AiresPucrs/cats-vs-dogs")
|
37 |
+
model.trainable = False
|
38 |
+
model.summary()
|
39 |
+
|
40 |
+
```
|
41 |
+
|
42 |
+
## Intended Use
|
43 |
+
|
44 |
+
This model was created for research purposes only. We do not recommend any application of this model outside this scope.
|
45 |
+
|
46 |
+
|
47 |
+
## Performance Metrics
|
48 |
+
|
49 |
+
Accuracy
|
50 |
+
|
51 |
+
## Training Data
|
52 |
+
|
53 |
+
[cats_vs_dogs dataset](https://www.tensorflow.org/datasets/catalog/cats_vs_dogs).
|
54 |
+
|
55 |
+
The dataset consists of a set of images of cats and dogs.
|
56 |
+
|
57 |
+
**Details:**
|
58 |
+
|
59 |
+
- [Homepage](https://www.microsoft.com/en-us/download/details.aspx?id=54765)
|
60 |
+
- Version: 1.0
|
61 |
+
- Date Published: 5/9/2022
|
62 |
+
- File Size:786.7 MB
|
63 |
+
|
64 |
+
## Training hyperparameters
|
65 |
|
66 |
The following hyperparameters were used during training:
|
67 |
|
|
|
75 |
| epsilon | 1e-07 |
|
76 |
| centered | False |
|
77 |
| training_precision | float32 |
|
78 |
+
## Limitations
|
79 |
+
We do not recommend using this model in real-world applications. It was solely developed for academic and educational purposes.
|
80 |
+
|
81 |
+
## Cite as
|
82 |
+
|
83 |
+
```latex
|
84 |
+
@misc{teenytinycastle,
|
85 |
+
doi = {10.5281/zenodo.7112065},
|
86 |
+
url = {https://github.com/Nkluge-correa/teeny-tiny_castle},
|
87 |
+
author = {Nicholas Kluge Corr{\^e}a},
|
88 |
+
title = {Teeny-Tiny Castle},
|
89 |
+
year = {2024},
|
90 |
+
publisher = {GitHub},
|
91 |
+
journal = {GitHub repository},
|
92 |
+
}
|
93 |
+
```
|
94 |
+
|
95 |
+
## License
|
96 |
+
|
97 |
+
The cats-vs-dogs pre-trained model is under the Apache 2.0 License.
|
98 |
|
99 |
+
The cats_vs_dogs Dataset is licensed under the [Creative Commons(CC) License CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by/4.0/).
|
100 |
|
101 |
## Model Plot
|
102 |
|