Migrate model card from transformers-repo
Browse filesRead announcement at https://discuss.huggingface.co/t/announcement-all-model-cards-will-be-migrated-to-hf-co-model-repos/2755
Original file history: https://github.com/huggingface/transformers/commits/master/model_cards/TurkuNLP/bert-base-finnish-cased-v1/README.md
README.md
ADDED
@@ -0,0 +1,84 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
---
|
2 |
+
language: fi
|
3 |
+
---
|
4 |
+
|
5 |
+
## Quickstart
|
6 |
+
|
7 |
+
**Release 1.0** (November 25, 2019)
|
8 |
+
|
9 |
+
Download the models here:
|
10 |
+
|
11 |
+
* Cased Finnish BERT Base: [bert-base-finnish-cased-v1.zip](http://dl.turkunlp.org/finbert/bert-base-finnish-cased-v1.zip)
|
12 |
+
* Uncased Finnish BERT Base: [bert-base-finnish-uncased-v1.zip](http://dl.turkunlp.org/finbert/bert-base-finnish-uncased-v1.zip)
|
13 |
+
|
14 |
+
We generally recommend the use of the cased model.
|
15 |
+
|
16 |
+
Paper presenting Finnish BERT: [arXiv:1912.07076](https://arxiv.org/abs/1912.07076)
|
17 |
+
|
18 |
+
## What's this?
|
19 |
+
|
20 |
+
A version of Google's [BERT](https://github.com/google-research/bert) deep transfer learning model for Finnish. The model can be fine-tuned to achieve state-of-the-art results for various Finnish natural language processing tasks.
|
21 |
+
|
22 |
+
FinBERT features a custom 50,000 wordpiece vocabulary that has much better coverage of Finnish words than e.g. the previously released [multilingual BERT](https://github.com/google-research/bert/blob/master/multilingual.md) models from Google:
|
23 |
+
|
24 |
+
| Vocabulary | Example |
|
25 |
+
|------------|---------|
|
26 |
+
| FinBERT | Suomessa vaihtuu kesän aikana sekä pääministeri että valtiovarain ##ministeri . |
|
27 |
+
| Multilingual BERT | Suomessa vai ##htuu kes ##än aikana sekä p ##ää ##minister ##i että valt ##io ##vara ##in ##minister ##i . |
|
28 |
+
|
29 |
+
FinBERT has been pre-trained for 1 million steps on over 3 billion tokens (24B characters) of Finnish text drawn from news, online discussion, and internet crawls. By contrast, Multilingual BERT was trained on Wikipedia texts, where the Finnish Wikipedia text is approximately 3% of the amount used to train FinBERT.
|
30 |
+
|
31 |
+
These features allow FinBERT to outperform not only Multilingual BERT but also all previously proposed models when fine-tuned for Finnish natural language processing tasks.
|
32 |
+
|
33 |
+
## Results
|
34 |
+
|
35 |
+
### Document classification
|
36 |
+
|
37 |
+
![learning curves for Yle and Ylilauta document classification](https://raw.githubusercontent.com/TurkuNLP/FinBERT/master/img/yle-ylilauta-curves.png)
|
38 |
+
|
39 |
+
FinBERT outperforms multilingual BERT (M-BERT) on document classification over a range of training set sizes on the Yle news (left) and Ylilauta online discussion (right) corpora. (Baseline classification performance with [FastText](https://fasttext.cc/) included for reference.)
|
40 |
+
|
41 |
+
[[code](https://github.com/spyysalo/finbert-text-classification)][[Yle data](https://github.com/spyysalo/yle-corpus)] [[Ylilauta data](https://github.com/spyysalo/ylilauta-corpus)]
|
42 |
+
|
43 |
+
### Named Entity Recognition
|
44 |
+
|
45 |
+
Evaluation on FiNER corpus ([Ruokolainen et al 2019](https://arxiv.org/abs/1908.04212))
|
46 |
+
|
47 |
+
| Model | Accuracy |
|
48 |
+
|--------------------|----------|
|
49 |
+
| **FinBERT** | **92.40%** |
|
50 |
+
| Multilingual BERT | 90.29% |
|
51 |
+
| [FiNER-tagger](https://github.com/Traubert/FiNer-rules) (rule-based) | 86.82% |
|
52 |
+
|
53 |
+
(FiNER tagger results from [Ruokolainen et al. 2019](https://arxiv.org/pdf/1908.04212.pdf))
|
54 |
+
|
55 |
+
[[code](https://github.com/jouniluoma/keras-bert-ner)][[data](https://github.com/mpsilfve/finer-data)]
|
56 |
+
|
57 |
+
### Part of speech tagging
|
58 |
+
|
59 |
+
Evaluation on three Finnish corpora annotated with [Universal Dependencies](https://universaldependencies.org/) part-of-speech tags: the Turku Dependency Treebank (TDT), FinnTreeBank (FTB), and Parallel UD treebank (PUD)
|
60 |
+
|
61 |
+
| Model | TDT | FTB | PUD |
|
62 |
+
|-------------------|-------------|-------------|-------------|
|
63 |
+
| **FinBERT** | **98.23%** | **98.39%** | **98.08%** |
|
64 |
+
| Multilingual BERT | 96.97% | 95.87% | 97.58% |
|
65 |
+
|
66 |
+
[[code](https://github.com/spyysalo/bert-pos)][[data](http://hdl.handle.net/11234/1-2837)]
|
67 |
+
|
68 |
+
## Use with PyTorch
|
69 |
+
|
70 |
+
If you want to use the model with the huggingface/transformers library, follow the steps in [huggingface_transformers.md](https://github.com/TurkuNLP/FinBERT/blob/master/huggingface_transformers.md)
|
71 |
+
|
72 |
+
## Previous releases
|
73 |
+
|
74 |
+
### Release 0.2
|
75 |
+
|
76 |
+
**October 24, 2019** Beta version of the BERT base uncased model trained from scratch on a corpus of Finnish news, online discussions, and crawled data.
|
77 |
+
|
78 |
+
Download the model here: [bert-base-finnish-uncased.zip](http://dl.turkunlp.org/finbert/bert-base-finnish-uncased.zip)
|
79 |
+
|
80 |
+
### Release 0.1
|
81 |
+
|
82 |
+
**September 30, 2019** We release a beta version of the BERT base cased model trained from scratch on a corpus of Finnish news, online discussions, and crawled data.
|
83 |
+
|
84 |
+
Download the model here: [bert-base-finnish-cased.zip](http://dl.turkunlp.org/finbert/bert-base-finnish-cased.zip)
|