dieineb commited on
Commit
c6458c3
1 Parent(s): 5f8607b

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +72 -8
README.md CHANGED
@@ -2,23 +2,66 @@
2
  library_name: keras
3
  tags:
4
  - Image Classification
 
 
 
 
5
  ---
6
 
7
- ## Model description
8
 
9
- More information needed
10
 
11
- ## Intended uses & limitations
12
 
13
- More information needed
14
 
15
- ## Training and evaluation data
 
 
 
 
 
 
16
 
17
- More information needed
18
 
19
- ## Training procedure
 
20
 
21
- ### Training hyperparameters
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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