readme: add initial version (#1)

- readme: add initial version (a306ec4b0e6ec5a19a86cee80d99fb261d7d966e)

README.md

@@ -0,0 +1,87 @@
+---
+language: nl
+license: mit
+tags:
+- flair
+- token-classification
+- sequence-tagger-model
+base_model: hmbyt5-preliminary/byt5-small-historic-multilingual-span20-flax
+inference: false
+widget:
+- text: Professoren der Geneeskun dige Faculteit te Groningen alsook van de HH , Doctoren
+    en Chirurgijns van Groningen , Friesland , Noordholland , Overijssel , Gelderland
+    , Drenthe , in welke Provinciën dit Elixir als Medicament voor Mond en Tanden
+    reeds jaren bakend is .
+---
+
+# Fine-tuned Flair Model on Dutch ICDAR-Europeana NER Dataset
+
+This Flair model was fine-tuned on the
+[Dutch ICDAR-Europeana](https://github.com/stefan-it/historic-domain-adaptation-icdar)
+NER Dataset using hmByT5 as backbone LM.
+
+The ICDAR-Europeana NER Dataset is a preprocessed variant of the
+[Europeana NER Corpora](https://github.com/EuropeanaNewspapers/ner-corpora) for Dutch and French.
+
+The following NEs were annotated: `PER`, `LOC` and `ORG`.
+
+# ⚠️ Inference Widget ⚠️
+
+Fine-Tuning ByT5 models in Flair is currently done by implementing an own [`ByT5Embedding`][1] class.
+
+This class needs to be present when running the model with Flair.
+
+Thus, the inference widget is not working with hmByT5 at the moment on the Model Hub and is currently disabled.
+
+This should be fixed in future, when ByT5 fine-tuning is supported in Flair directly.
+
+[1]: https://github.com/stefan-it/hmBench/blob/main/byt5_embeddings.py
+
+# Results
+
+We performed a hyper-parameter search over the following parameters with 5 different seeds per configuration:
+
+* Batch Sizes: `[8, 4]`
+* Learning Rates: `[0.00015, 0.00016]`
+
+And report micro F1-score on development set:
+
+| Configuration     | Run 1        | Run 2        | Run 3        | Run 4        | Run 5        | Avg.         |
+|-------------------|--------------|--------------|--------------|--------------|--------------|--------------|
+| bs8-e10-lr0.00015 | [0.871][1]   | [0.8751][2]  | [0.8748][3]  | [0.8547][4]  | [0.8673][5]  | 86.86 ± 0.75 |
+| bs8-e10-lr0.00016 | [0.8549][6]  | [0.8713][7]  | [0.8698][8]  | [0.8539][9]  | [0.8665][10] | 86.33 ± 0.74 |
+| bs4-e10-lr0.00016 | [0.8516][11] | [0.8654][12] | [0.87][13]   | [0.8642][14] | [0.8541][15] | 86.11 ± 0.7  |
+| bs4-e10-lr0.00015 | [0.8599][16] | [0.8649][17] | [0.8652][18] | [0.8482][19] | [0.854][20]  | 85.84 ± 0.65 |
+
+[1]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs8-wsFalse-e10-lr0.00015-poolingfirst-layers-1-crfFalse-1
+[2]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs8-wsFalse-e10-lr0.00015-poolingfirst-layers-1-crfFalse-2
+[3]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs8-wsFalse-e10-lr0.00015-poolingfirst-layers-1-crfFalse-3
+[4]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs8-wsFalse-e10-lr0.00015-poolingfirst-layers-1-crfFalse-4
+[5]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs8-wsFalse-e10-lr0.00015-poolingfirst-layers-1-crfFalse-5
+[6]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs8-wsFalse-e10-lr0.00016-poolingfirst-layers-1-crfFalse-1
+[7]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs8-wsFalse-e10-lr0.00016-poolingfirst-layers-1-crfFalse-2
+[8]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs8-wsFalse-e10-lr0.00016-poolingfirst-layers-1-crfFalse-3
+[9]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs8-wsFalse-e10-lr0.00016-poolingfirst-layers-1-crfFalse-4
+[10]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs8-wsFalse-e10-lr0.00016-poolingfirst-layers-1-crfFalse-5
+[11]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs4-wsFalse-e10-lr0.00016-poolingfirst-layers-1-crfFalse-1
+[12]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs4-wsFalse-e10-lr0.00016-poolingfirst-layers-1-crfFalse-2
+[13]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs4-wsFalse-e10-lr0.00016-poolingfirst-layers-1-crfFalse-3
+[14]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs4-wsFalse-e10-lr0.00016-poolingfirst-layers-1-crfFalse-4
+[15]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs4-wsFalse-e10-lr0.00016-poolingfirst-layers-1-crfFalse-5
+[16]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs4-wsFalse-e10-lr0.00015-poolingfirst-layers-1-crfFalse-1
+[17]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs4-wsFalse-e10-lr0.00015-poolingfirst-layers-1-crfFalse-2
+[18]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs4-wsFalse-e10-lr0.00015-poolingfirst-layers-1-crfFalse-3
+[19]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs4-wsFalse-e10-lr0.00015-poolingfirst-layers-1-crfFalse-4
+[20]: https://hf.co/hmbench/hmbench-icdar-nl-hmbyt5-bs4-wsFalse-e10-lr0.00015-poolingfirst-layers-1-crfFalse-5
+
+The [training log](training.log) and TensorBoard logs are also uploaded to the model hub.
+
+More information about fine-tuning can be found [here](https://github.com/stefan-it/hmBench).
+
+# Acknowledgements
+
+We thank [Luisa März](https://github.com/LuisaMaerz), [Katharina Schmid](https://github.com/schmika) and
+[Erion Çano](https://github.com/erionc) for their fruitful discussions about Historic Language Models.
+
+Research supported with Cloud TPUs from Google's [TPU Research Cloud](https://sites.research.google/trc/about/) (TRC).
+Many Thanks for providing access to the TPUs ❤️