ddecosmo commited on
Commit
d8fe074
·
verified ·
1 Parent(s): c29c1c4

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +117 -6
README.md CHANGED
@@ -1,12 +1,123 @@
1
  ---
 
2
  license: mit
3
  datasets:
4
  - maryzhang/hw1-24679-image-dataset
5
  language:
6
  - en
7
- metrics:
8
- - accuracy
9
- base_model:
10
- - timm/mobilenetv3_small_100.lamb_in1k
11
- pipeline_tag: image-classification
12
- ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ '[object Object]': null
3
  license: mit
4
  datasets:
5
  - maryzhang/hw1-24679-image-dataset
6
  language:
7
  - en
8
+ ---
9
+
10
+ # Model Card for {{ model_id | default("Model ID", true) }}
11
+
12
+ <!-- Provide a quick summary of what the model is/does. -->
13
+
14
+ This is a fine tuned version of the TimmAutoModel for classification. This was fine tuned on the maryzhang/hw1-24679-image-dataset which is a dataset of Western and Asian dishes used for binary classification.
15
+
16
+ ## Model Details
17
+
18
+ ### Model Description
19
+
20
+ This model uses the TimmAutoModel with accuracy as the main parameter and multi class accuracy and cross entropy as the main hyperparameters.
21
+
22
+ - **Developed by:** Devin DeCosmo
23
+ - **Model type:** Image Classifier
24
+ - **Language(s) (NLP):** English
25
+ - **License:** MIT
26
+ - **Finetuned from model:** TimmAutoModel
27
+
28
+ ### Model Sources [optional]
29
+
30
+ <!-- Provide the basic links for the model. -->
31
+
32
+ - **Repository:** {{ repo | default("[More Information Needed]", true)}}
33
+
34
+
35
+ ## Uses
36
+
37
+ <!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. -->
38
+
39
+ This could be used for general image classification tasks, especially those for culinary uses.
40
+
41
+ ### Direct Use
42
+
43
+ <!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
44
+
45
+ The direct use would be to classify food as either Western or Asian based on an image.
46
+
47
+ ### Out-of-Scope Use
48
+
49
+ <!-- This section addresses misuse, malicious use, and uses that the model will not work well for. -->
50
+
51
+ If the dataset was expanded, this could be used to classify other types of food among numerous other classes.
52
+
53
+ ## Bias, Risks, and Limitations
54
+
55
+ <!-- This section is meant to convey both technical and sociotechnical limitations. -->
56
+
57
+ This is trained off a small dataset of 30 original photos and 300 augmented photos. This could suggest overfitting of the model and additional information is required to make it more robust.
58
+
59
+ ### Recommendations
60
+
61
+ <!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. -->
62
+
63
+ The small dataset size means this model is not highly generalizable.
64
+
65
+ ## How to Get Started with the Model
66
+
67
+ Use the code below to get started with the model.
68
+
69
+ ## Training Details
70
+
71
+ ### Training Data
72
+
73
+ <!-- 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. -->
74
+
75
+ maryzhang/hw1-24679-image-dataset
76
+
77
+ This is the training dataset used.
78
+ It consists of 30 original images used for validation along with 300 synthetic pieces of data from training.
79
+
80
+ ### Training Procedure
81
+
82
+ <!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->
83
+ This model was trained with an AutoML process with accuracy as the main metrics. The modelw as trained over 20 epochs with a batch size of 32 images.
84
+
85
+
86
+ #### Training Hyperparameters
87
+
88
+ - **Training regime:** {{ training_regime | default("[More Information Needed]", true)}} <!--fp32, fp16 mixed precision, bf16 mixed precision, bf16 non-mixed precision, fp16 non-mixed precision, fp8 mixed precision -->
89
+
90
+
91
+ ## Evaluation
92
+
93
+ <!-- This section describes the evaluation protocols and provides the results. -->
94
+
95
+ ### Testing Data, Factors & Metrics
96
+
97
+ #### Testing Data
98
+
99
+ <!-- This should link to a Dataset Card if possible. -->
100
+ maryzhang/hw1-24679-image-dataset
101
+ The testing data was the 'original' split, the 30 original images in this set.
102
+
103
+ #### Factors
104
+
105
+ <!-- These are the things the evaluation is disaggregating by, e.g., subpopulations or domains. -->
106
+
107
+ This dataset is evaluating whether the food is Western, "1", or Asian, "0".
108
+
109
+ #### Metrics
110
+
111
+ <!-- These are the evaluation metrics being used, ideally with a description of why. -->
112
+
113
+ The testing metric used was accuracy to ensure the highest accuracy of the model possible.
114
+
115
+
116
+ ### Results
117
+
118
+ After training with the initial dataset, this model reached an accuracy of 95% in validation.
119
+
120
+ #### Summary
121
+
122
+ This model reached a high accuracy with our current model, but this perfomance can not be confirmed to continue as the dataset was very small.
123
+