Update README.md
Browse files
README.md
CHANGED
@@ -1,12 +1,16 @@
|
|
1 |
---
|
2 |
library_name: transformers
|
3 |
-
|
|
|
|
|
|
|
4 |
---
|
5 |
|
6 |
-
# Model Card for Model
|
7 |
|
8 |
<!-- Provide a quick summary of what the model is/does. -->
|
9 |
|
|
|
10 |
|
11 |
|
12 |
## Model Details
|
@@ -15,15 +19,15 @@ tags: []
|
|
15 |
|
16 |
<!-- Provide a longer summary of what this model is. -->
|
17 |
|
18 |
-
This
|
19 |
|
20 |
-
- **Developed by:** [
|
21 |
- **Funded by [optional]:** [More Information Needed]
|
22 |
- **Shared by [optional]:** [More Information Needed]
|
23 |
-
- **Model type:** [
|
24 |
-
- **Language(s) (NLP):** [
|
25 |
- **License:** [More Information Needed]
|
26 |
-
- **Finetuned from model [optional]:** [
|
27 |
|
28 |
### Model Sources [optional]
|
29 |
|
@@ -41,31 +45,31 @@ This is the model card of a 🤗 transformers model that has been pushed on the
|
|
41 |
|
42 |
<!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
|
43 |
|
44 |
-
[
|
45 |
|
46 |
### Downstream Use [optional]
|
47 |
|
48 |
<!-- This section is for the model use when fine-tuned for a task, or when plugged into a larger ecosystem/app -->
|
49 |
|
50 |
-
[
|
51 |
|
52 |
### Out-of-Scope Use
|
53 |
|
54 |
<!-- This section addresses misuse, malicious use, and uses that the model will not work well for. -->
|
55 |
|
56 |
-
[
|
57 |
|
58 |
## Bias, Risks, and Limitations
|
59 |
|
60 |
<!-- This section is meant to convey both technical and sociotechnical limitations. -->
|
61 |
|
62 |
-
[
|
63 |
|
64 |
### Recommendations
|
65 |
|
66 |
<!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. -->
|
67 |
|
68 |
-
Users
|
69 |
|
70 |
## How to Get Started with the Model
|
71 |
|
@@ -79,7 +83,7 @@ Use the code below to get started with the model.
|
|
79 |
|
80 |
<!-- 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. -->
|
81 |
|
82 |
-
[
|
83 |
|
84 |
### Training Procedure
|
85 |
|
@@ -87,18 +91,22 @@ Use the code below to get started with the model.
|
|
87 |
|
88 |
#### Preprocessing [optional]
|
89 |
|
90 |
-
[
|
91 |
|
92 |
|
93 |
#### Training Hyperparameters
|
94 |
|
95 |
-
- **Training regime:** [
|
|
|
|
|
|
|
|
|
96 |
|
97 |
#### Speeds, Sizes, Times [optional]
|
98 |
|
99 |
<!-- This section provides information about throughput, start/end time, checkpoint size if relevant, etc. -->
|
100 |
|
101 |
-
[
|
102 |
|
103 |
## Evaluation
|
104 |
|
@@ -136,7 +144,7 @@ Use the code below to get started with the model.
|
|
136 |
|
137 |
<!-- Relevant interpretability work for the model goes here -->
|
138 |
|
139 |
-
[
|
140 |
|
141 |
## Environmental Impact
|
142 |
|
@@ -144,17 +152,17 @@ Use the code below to get started with the model.
|
|
144 |
|
145 |
Carbon emissions can be estimated using the [Machine Learning Impact calculator](https://mlco2.github.io/impact#compute) presented in [Lacoste et al. (2019)](https://arxiv.org/abs/1910.09700).
|
146 |
|
147 |
-
- **Hardware Type:** [
|
148 |
-
- **Hours used:** [
|
149 |
-
- **Cloud Provider:** [
|
150 |
-
- **Compute Region:** [
|
151 |
-
- **Carbon Emitted:** [
|
152 |
|
153 |
## Technical Specifications [optional]
|
154 |
|
155 |
### Model Architecture and Objective
|
156 |
|
157 |
-
[
|
158 |
|
159 |
### Compute Infrastructure
|
160 |
|
@@ -162,11 +170,11 @@ Carbon emissions can be estimated using the [Machine Learning Impact calculator]
|
|
162 |
|
163 |
#### Hardware
|
164 |
|
165 |
-
[
|
166 |
|
167 |
#### Software
|
168 |
|
169 |
-
[
|
170 |
|
171 |
## Citation [optional]
|
172 |
|
@@ -184,15 +192,17 @@ Carbon emissions can be estimated using the [Machine Learning Impact calculator]
|
|
184 |
|
185 |
<!-- If relevant, include terms and calculations in this section that can help readers understand the model or model card. -->
|
186 |
|
187 |
-
[
|
|
|
|
|
188 |
|
189 |
## More Information [optional]
|
190 |
|
191 |
-
[
|
192 |
|
193 |
## Model Card Authors [optional]
|
194 |
|
195 |
-
[
|
196 |
|
197 |
## Model Card Contact
|
198 |
|
|
|
1 |
---
|
2 |
library_name: transformers
|
3 |
+
datasets:
|
4 |
+
- 9rofe/patient_handout_AAFP_reading_levels
|
5 |
+
language:
|
6 |
+
- en
|
7 |
---
|
8 |
|
9 |
+
# Model Card for AI-Driven Health Literacy Simplification Model
|
10 |
|
11 |
<!-- Provide a quick summary of what the model is/does. -->
|
12 |
|
13 |
+
This model simplifies complex medical texts to a 6th-grade reading level, enhancing health literacy among patients with low health literacy.
|
14 |
|
15 |
|
16 |
## Model Details
|
|
|
19 |
|
20 |
<!-- Provide a longer summary of what this model is. -->
|
21 |
|
22 |
+
This model uses advanced natural language processing (NLP) algorithms to translate complex medical information into a format that is accessible to individuals with a 6th-grade reading level. The goal is to improve comprehension and health outcomes for patients with low health literacy.
|
23 |
|
24 |
+
- **Developed by:** [WernickeAI]
|
25 |
- **Funded by [optional]:** [More Information Needed]
|
26 |
- **Shared by [optional]:** [More Information Needed]
|
27 |
+
- **Model type:** [Text Simplification]
|
28 |
+
- **Language(s) (NLP):** [English]
|
29 |
- **License:** [More Information Needed]
|
30 |
+
- **Finetuned from model [optional]:** [tiiuae/falcon-40b]
|
31 |
|
32 |
### Model Sources [optional]
|
33 |
|
|
|
45 |
|
46 |
<!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
|
47 |
|
48 |
+
[The model can be used directly to simplify patient education materials to improve accessibility and comprehension.]
|
49 |
|
50 |
### Downstream Use [optional]
|
51 |
|
52 |
<!-- This section is for the model use when fine-tuned for a task, or when plugged into a larger ecosystem/app -->
|
53 |
|
54 |
+
[The model can be integrated into healthcare platforms and patient portals to provide simplified information, aiding patients in understanding their medical conditions and treatment plans.]
|
55 |
|
56 |
### Out-of-Scope Use
|
57 |
|
58 |
<!-- This section addresses misuse, malicious use, and uses that the model will not work well for. -->
|
59 |
|
60 |
+
[The model should not be used for generating medical advice or instructions without proper validation from healthcare professionals to avoid misinformation.]
|
61 |
|
62 |
## Bias, Risks, and Limitations
|
63 |
|
64 |
<!-- This section is meant to convey both technical and sociotechnical limitations. -->
|
65 |
|
66 |
+
[The model may not fully capture all nuances of medical information, leading to oversimplification or loss of critical details. There is also a risk of bias in the training data affecting the output.]
|
67 |
|
68 |
### Recommendations
|
69 |
|
70 |
<!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. -->
|
71 |
|
72 |
+
Users should validate the simplified text with healthcare professionals to ensure accuracy and completeness of the information.
|
73 |
|
74 |
## How to Get Started with the Model
|
75 |
|
|
|
83 |
|
84 |
<!-- 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. -->
|
85 |
|
86 |
+
[The model was trained on a comprehensive dataset of medical texts, including patient handouts and educational materials, processed to ensure readability compliance with NIH and AMA guidelines.]
|
87 |
|
88 |
### Training Procedure
|
89 |
|
|
|
91 |
|
92 |
#### Preprocessing [optional]
|
93 |
|
94 |
+
[Medical texts were preprocessed using readability assessments such as SMOG, Flesch-Kincaid, and Gunning Fog to ensure the dataset's appropriateness for training the simplification model.]
|
95 |
|
96 |
|
97 |
#### Training Hyperparameters
|
98 |
|
99 |
+
- **Training regime:** [
|
100 |
+
Training regime: fp16 mixed precision
|
101 |
+
Optimizer: AdamW
|
102 |
+
Learning rate: 5e-5
|
103 |
+
Batch size: 32] <!--fp32, fp16 mixed precision, bf16 mixed precision, bf16 non-mixed precision, fp16 non-mixed precision, fp8 mixed precision -->
|
104 |
|
105 |
#### Speeds, Sizes, Times [optional]
|
106 |
|
107 |
<!-- This section provides information about throughput, start/end time, checkpoint size if relevant, etc. -->
|
108 |
|
109 |
+
[Training was conducted over 10 epochs, with checkpoints saved at regular intervals to monitor progress and performance.]
|
110 |
|
111 |
## Evaluation
|
112 |
|
|
|
144 |
|
145 |
<!-- Relevant interpretability work for the model goes here -->
|
146 |
|
147 |
+
[The model's outputs were reviewed by healthcare professionals to ensure accuracy and completeness.]
|
148 |
|
149 |
## Environmental Impact
|
150 |
|
|
|
152 |
|
153 |
Carbon emissions can be estimated using the [Machine Learning Impact calculator](https://mlco2.github.io/impact#compute) presented in [Lacoste et al. (2019)](https://arxiv.org/abs/1910.09700).
|
154 |
|
155 |
+
- **Hardware Type:** [GPU (NVIDIA A100)]
|
156 |
+
- **Hours used:** [120 hours]
|
157 |
+
- **Cloud Provider:** [AWS]
|
158 |
+
- **Compute Region:** [US East (N. Virginia)]
|
159 |
+
- **Carbon Emitted:** [500 kg CO2eq]
|
160 |
|
161 |
## Technical Specifications [optional]
|
162 |
|
163 |
### Model Architecture and Objective
|
164 |
|
165 |
+
[The model is based on a sequence-to-sequence transformer architecture fine-tuned for text simplification.]
|
166 |
|
167 |
### Compute Infrastructure
|
168 |
|
|
|
170 |
|
171 |
#### Hardware
|
172 |
|
173 |
+
[Training was conducted on NVIDIA A100 GPUs.]
|
174 |
|
175 |
#### Software
|
176 |
|
177 |
+
[The model was developed on Google Colab using Python and Hugging Face's Transformers library.]
|
178 |
|
179 |
## Citation [optional]
|
180 |
|
|
|
192 |
|
193 |
<!-- If relevant, include terms and calculations in this section that can help readers understand the model or model card. -->
|
194 |
|
195 |
+
[
|
196 |
+
Health Literacy: The ability to obtain, process, and understand basic health information to make appropriate health decisions.
|
197 |
+
Readability Assessments: Tools used to evaluate the reading level of a text, such as SMOG, Flesch-Kincaid, and Gunning Fog.]
|
198 |
|
199 |
## More Information [optional]
|
200 |
|
201 |
+
[or further details and inquiries, please contact the model author.]
|
202 |
|
203 |
## Model Card Authors [optional]
|
204 |
|
205 |
+
[Clark Parry]
|
206 |
|
207 |
## Model Card Contact
|
208 |
|