Create README.md

README.md

@@ -0,0 +1,77 @@
+---
+language: nl
+license: mit
+pipeline_tag: text-classification
+inference: false
+---
+
+# Regression Model for Eating Functioning Levels (ICF d550)
+
+## Description
+A fine-tuned regression model that assigns a functioning level to Dutch sentences describing eating functions. The model is based on a pre-trained Dutch medical language model ([link to be added]()): a RoBERTa model, trained from scratch on clinical notes of the Amsterdam UMC. To detect sentences about eating functions in clinical text in Dutch, use the [icf-domains](https://huggingface.co/CLTL/icf-domains) classification model.
+
+## Functioning levels
+Level | Meaning
+---|---
+4 | Can eat independently (in culturally acceptable ways), good intake, eats according to her/his needs.
+3 | Can eat independently but with adjustments, and/or somewhat reduced intake (>75% of her/his needs), and/or good intake can be achieved with proper advice.
+2 | Reduced intake, and/or stimulus / feeding modules / nutrition drinks are needed (but not tube feeding / TPN).
+1 | Intake is severely reduced (<50% of her/his needs), and/or tube feeding / TPN is needed.
+0 | Cannot eat, and/or fully dependent on tube feeding / TPN.
+
+The predictions generated by the model might sometimes be outside of the scale (e.g. 4.2); this is normal in a regression model.
+
+## Intended uses and limitations
+- The model was fine-tuned (trained, validated and tested) on medical records from the Amsterdam UMC (the two academic medical centers of Amsterdam). It might perform differently on text from a different hospital or text from non-hospital sources (e.g. GP records).
+- The model was fine-tuned with the [Simple Transformers](https://simpletransformers.ai/) library. This library is based on Transformers but the model cannot be used directly with Transformers `pipeline` and classes; doing so would generate incorrect outputs. For this reason, the API on this page is disabled.
+
+## How to use
+To generate predictions with the model, use the [Simple Transformers](https://simpletransformers.ai/) library:
+```
+from simpletransformers.classification import ClassificationModel
+
+model = ClassificationModel(
+    'roberta',
+    'CLTL/icf-levels-etn',
+    use_cuda=False,
+)
+
+example = 'Sondevoeding is geïndiceerd'
+_, raw_outputs = model.predict([example])
+predictions = np.squeeze(raw_outputs)
+```
+The prediction on the example is:
+```
+0.89
+```
+The raw outputs look like this:
+```
+[[0.8872931]]
+```
+
+## Training data
+- The training data consists of clinical notes from medical records (in Dutch) of the Amsterdam UMC. Due to privacy constraints, the data cannot be released.
+- The annotation guidelines used for the project can be found [here](https://github.com/cltl/a-proof-zonmw/tree/main/resources/annotation_guidelines).
+
+## Training procedure
+The default training parameters of Simple Transformers were used, including:
+- Optimizer: AdamW
+- Learning rate: 4e-5
+- Num train epochs: 1
+- Train batch size: 8
+
+## Evaluation results
+The evaluation is done on a sentence-level (the classification unit) and on a note-level (the aggregated unit which is meaningful for the healthcare professionals).
+
+| | Sentence-level | Note-level
+|---|---|---
+mean absolute error | 0.59 | 0.50
+mean squared error | 0.65 | 0.47
+root mean squared error | 0.81 | 0.68
+
+## Authors and references
+### Authors
+Jenia Kim, Piek Vossen
+
+### References
+TBD