rwood-97 commited on
Commit
c9df162
1 Parent(s): 85a4679

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +17 -97
README.md CHANGED
@@ -27,7 +27,7 @@ Fine-tuned on gold standard annotations and outputs from early experiments using
27
 
28
  - **Model type:** Image classification /feature backbone
29
  - **Finetuned from model:** https://huggingface.co/timm/tf_efficientnet_b3.ns_jft_in1k
30
- -
31
  ## Uses
32
 
33
  <!-- 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,124 +38,44 @@ Fine-tuned on gold standard annotations and outputs from early experiments using
38
 
39
  {{ direct_use | default("[More Information Needed]", true)}}
40
 
41
- ### Downstream Use [optional]
42
-
43
- <!-- This section is for the model use when fine-tuned for a task, or when plugged into a larger ecosystem/app -->
44
-
45
- {{ downstream_use | default("[More Information Needed]", true)}}
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
- {{ out_of_scope_use | default("[More Information Needed]", true)}}
52
-
53
  ## Bias, Risks, and Limitations
54
 
55
  <!-- This section is meant to convey both technical and sociotechnical limitations. -->
56
 
57
  {{ bias_risks_limitations | default("[More Information Needed]", true)}}
58
 
59
- ### Recommendations
60
-
61
- <!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. -->
62
-
63
- {{ bias_recommendations | default("Users (both direct and downstream) should be made aware of the risks, biases and limitations of the model. More information needed for further recommendations.", true)}}
64
-
65
- ## How to Get Started with the Model
66
-
67
- Use the code below to get started with the model.
68
-
69
- {{ get_started_code | default("[More Information Needed]", true)}}
70
-
71
- ## Training Details
72
-
73
- ### Training Data
74
-
75
- <!-- This should link to a Data 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. -->
76
-
77
- {{ training_data | default("[More Information Needed]", true)}}
78
-
79
- ### Training Procedure
80
-
81
- <!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->
82
-
83
- #### Preprocessing [optional]
84
-
85
- {{ preprocessing | default("[More Information Needed]", true)}}
86
-
87
-
88
- #### Training Hyperparameters
89
 
90
- - **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 -->
91
 
92
- #### Speeds, Sizes, Times [optional]
93
 
94
- <!-- This section provides information about throughput, start/end time, checkpoint size if relevant, etc. -->
95
 
96
- {{ speeds_sizes_times | default("[More Information Needed]", true)}}
97
 
98
- ## Evaluation
99
 
100
- <!-- This section describes the evaluation protocols and provides the results. -->
101
-
102
- ### Testing Data, Factors & Metrics
103
-
104
- #### Testing Data
105
-
106
- <!-- This should link to a Data Card if possible. -->
107
-
108
- {{ testing_data | default("[More Information Needed]", true)}}
109
-
110
- #### Factors
111
-
112
- <!-- These are the things the evaluation is disaggregating by, e.g., subpopulations or domains. -->
113
-
114
- {{ testing_factors | default("[More Information Needed]", true)}}
115
-
116
- #### Metrics
117
-
118
- <!-- These are the evaluation metrics being used, ideally with a description of why. -->
119
-
120
- {{ testing_metrics | default("[More Information Needed]", true)}}
121
 
122
  ### Results
123
 
124
- {{ results | default("[More Information Needed]", true)}}
125
-
126
- #### Summary
127
-
128
- {{ results_summary | default("", true) }}
129
-
130
- ## Model Examination [optional]
131
-
132
- <!-- Relevant interpretability work for the model goes here -->
133
-
134
- {{ model_examination | default("[More Information Needed]", true)}}
135
-
136
- ## Citation [optional]
137
-
138
- <!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->
139
-
140
- **BibTeX:**
141
-
142
- {{ citation_bibtex | default("[More Information Needed]", true)}}
143
-
144
- **APA:**
145
-
146
- {{ citation_apa | default("[More Information Needed]", true)}}
147
 
148
- ## More Information [optional]
149
 
150
- {{ more_information | default("[More Information Needed]", true)}}
 
151
 
152
- ## Model Card Authors [optional]
153
 
154
- {{ model_card_authors | default("[More Information Needed]", true)}}
 
155
 
156
  ## Model Card Contact
157
 
158
- {{ model_card_contact | default("[More Information Needed]", true)}}
159
 
160
  ## Funding Statement
161
 
 
27
 
28
  - **Model type:** Image classification /feature backbone
29
  - **Finetuned from model:** https://huggingface.co/timm/tf_efficientnet_b3.ns_jft_in1k
30
+
31
  ## Uses
32
 
33
  <!-- 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
  {{ direct_use | default("[More Information Needed]", true)}}
40
 
 
 
 
 
 
 
 
 
 
 
 
 
41
  ## Bias, Risks, and Limitations
42
 
43
  <!-- This section is meant to convey both technical and sociotechnical limitations. -->
44
 
45
  {{ bias_risks_limitations | default("[More Information Needed]", true)}}
46
 
47
+ ## How to Get Started with the Model in MapReader
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
48
 
49
+ Please go to [the MapReader documentation](https://mapreader.readthedocs.io/en/latest/User-guide/Classify.html) for instruction of how to use this model in MapReader.
50
 
51
+ ## Training, Evaluation and Testing Details
52
 
53
+ ### Training, Evaluation and Testing Data
54
 
55
+ This model was fine-tuned on [this data](https://huggingface.co/datasets/Livingwithmachines/MapReader_Data_SIGSPATIAL_2022).
56
 
57
+ ### Training, Evaluation and Testing Procedure
58
 
59
+ Details can be found [here](https://dl.acm.org/doi/10.1145/3557919.3565812).
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
60
 
61
  ### Results
62
 
63
+ Data outputs can be found [here](https://huggingface.co/datasets/Livingwithmachines/MapReader_Data_SIGSPATIAL_2022).
64
+ Further details can be found [here](https://dl.acm.org/doi/10.1145/3557919.3565812).
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
65
 
66
+ ## More Information
67
 
68
+ This model was fine-tuned using MapReader.
69
+ The code for which can be found [here](https://github.com/Living-with-machines/MapReader) and the documentation can be found [here](https://mapreader.readthedocs.io/en/latest/).
70
 
71
+ ## Model Card Authors
72
 
73
+ Katie McDonough ([email protected])
74
+ Rosie Wood ([email protected])
75
 
76
  ## Model Card Contact
77
 
78
+ Katie McDonough ([email protected])
79
 
80
  ## Funding Statement
81