sultan commited on
Commit
ba8b3f9
1 Parent(s): 0439e9a

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +113 -0
README.md ADDED
@@ -0,0 +1,113 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # ArabicT5: Efficient Adaptation of T5 on Arabic Language
2
+
3
+
4
+ # Model Description
5
+
6
+ This model adapts T5 on the Arabic Language by pre-training T5 on :
7
+ - Arabic Wikipedia.
8
+ - Marefa encyclopedia.
9
+ - Hindawi Books.
10
+ - a collection of Arabic News.
11
+ - OSCAR Dataset (32GB)
12
+
13
+ Total Corpora size is 49GB. This model uses an efficient implementation of T5 which reduces the fine-tuning and memory used [Link](https://arxiv.org/abs/2109.10686) and uses T5x for pre-training [Link](https://github.com/google-research/t5x)
14
+
15
+
16
+ ## Pre-training Settings and Results on TyDi QA Development Dataset ( Model in this card is highlighted in bold )
17
+
18
+ | Model | Hidden Layer | Atten. head | Atten. Layers | Vocab | Hardware |Training Steps | Batch | Train x Batch Factor |Corpora |
19
+ |------------------|--------------|-------------|---------------|-------|-----------|---------------|--------|-----------------------|------------------------|
20
+ | AraT5-base | 768 | 12 | 12 | 110K |TPUv3-8 | 1M | 128 | 1.0x |248GB 29B tokens (MSA + Tweets) |
21
+ | AraT5-msa-base | 768 | 12 | 12 | 110K |TPUv3-8 | 1M | 128 | 1.0x |70GB (MSA) |
22
+ | AraT5-tweets-base| 768 | 12 | 12 | 110K |TPUv3-8 | 1M | 128 | 1.0x |178GB (Tweets) |
23
+ | AraBART-base | 768 | 12 | 12 | 50K | 128 V100 GPUs (60h) |25 epochs| - | - |73GB (MSA) |
24
+ | mT5-base | 768 | 12 | 12 | 250K |TPUv3-32 | 1M | 1024 | 8.0x |6.3T tokens (mC4)|
25
+ | ArabicT5-17GB-small | 512 | 8 | 20 | 32K |TPUv3-32 | 256K | 256 | 0.5x |17GB (MSA) |
26
+ | ArabicT5-17GB-base | 768 | 12 | 16 | 32K |TPUv3-128 | 500K | 512 | 2.0x |17GB (MSA) |
27
+ | ArabicT5-49GB-base | 768 | 12 | 16 | 32K |TPUv3-64 | 500K | 256 | 1.0x |49GB (MSA + OSCAR) |
28
+ | ArabicT5-17GB-large | 768 | 12 | 36 | 32K |TPUv3-128 | 500K | 512 | 2.0x |17GB (MSA) |
29
+
30
+
31
+ ## Results on TyDi QA, HARD, Sentiment Analysis, Sarcasm Detection ( Best Score is highlighted in bold )
32
+
33
+ | Model | <center>TyDi QA| <center>HARD| <center>ArSarcasm-v2-Sentiment| <center>ArSarcasm-v2-Sarcasm| XL-SUM |
34
+ |----------------------|---------------|---------------------|-------------------------------------|----------------------------------|----------------------------------
35
+ | AraT5-base | <center>70.4/84.2 |<center>**96.5**|<center>69.7/72.6|<center>60.4|<center>30.3|
36
+ | AraT5-msa-base | <center>70.9/84.0 |<center>**96.5**|<center>70.0/72.7|<center>60.7|<center>27.4|
37
+ | AraT5-tweets-base | <center>65.1/79.0 |<center>96.3|<center>70.7/73.5|<center>61.1|<center>25.1|
38
+ | mT5-base | <center>72.2/84.1 |<center>96.2|<center>67.3/68.8|<center>52.2|<center>25.7|
39
+ | AraBART-base | <center>48.8/71.2 |<center>96.1|<center>66.2/68.2|<center>56.3|<center>31.2|
40
+ | ArabicT5-17GB-small | <center>70.8/84.8 |<center>96.4|<center>68.9/71.2|<center>58.9|<center>29.2|
41
+ | ArabicT5-17GB-base | <center>73.3/86.1 |<center>96.4|<center>70.4/73.0|<center>59.8|<center>30.3|
42
+ | ArabicT5-49GB-base | <center>73.1/85.5 |<center>96.5|<center>71.4/74.7|<center>60.4|<center>30.9|
43
+ | ArabicT5-17GB-large | <center>**75.5/87.1** |<center>**96.5**| <center>**72.2/75.2**|<center>**61.7**|<center>**31.7**|
44
+
45
+ Evaluation Metrics: TyDi QA (EM/F1), HARD (Accuracy), Sentiment Analysis (Accuracy / F1-PN positive-negative), Sarcasm Detection (F1-sarcastic), XL-SUM (Rouge-L with Stemmer).
46
+
47
+ You can download the full details of our grid search for all models in all tasks above from this link: https://github.com/salrowili/ArabicT5/raw/main/ArabicT5_Grid_Search.zip
48
+
49
+ For the XL-Sum task, we choose our best run for each model using the eval set. We use the official evaluation script from XL-Sum, which uses the stemmer function, which may show better results than papers that don't use the stemmer function. The official XL-Sum paper uses a stemmer function.
50
+
51
+ In our XL-Sum results, although we show that AraT5-Base exceeded our ArabicT5-Large, in most runs, our ArabicT5-Large shows better results, as you can see from our grid search file.
52
+
53
+ # Continual Pre-Training of ArabicT5 with T5x
54
+ if you want to continue pre-training ArabicT5 on your own data we have uploaded the raw t5x checkpoint to this link https://huggingface.co/sultan/ArabicT5-49GB-base/blob/main/arabict5_49GB_base_t5x.tar.gz
55
+ We will share soon a tutorial on how you can do that for free with Kaggle TPU
56
+ # Speedup Results
57
+
58
+
59
+ Below are our speedup results on the TyDi QA dataset, where all models have fine-tuned 13 epochs with a learning rate of 2e-4 and batch size of 3 on each device on the TPU (TPU3v-8 batch=3x8->24).
60
+
61
+ Please note these results when we fixed our hyperparameters for all models. Refer to the table above to get the best results after doing a grid search.
62
+
63
+
64
+ | <center>Model | <center>Run Time (hh:mm:ss) | <center>Results on TyDi QA |
65
+ |----------------------|---------------|---------------------|
66
+ | AraT5-msa-base | <center>00:20:41 |<center>69.92/82.50|
67
+ | AraT5-base | <center>00:20:53 |<center>68.40/81.97|
68
+ | AraT5-base-Tweets | <center>00:21:17 |<center>61.67/75.96|
69
+ | mT5-base | <center>00:28:24 |<center>57.98/72.81|
70
+ | AraBART-base | <center>00:10:57 |<center>43.76/66.30|
71
+ | ArabicT5-17GB-small | <center>00:20:00 |<center>70.79/83.85|
72
+ | ArabicT5-17GB-base | <center>00:23:50 |<center>71.22/84.42|
73
+ | ArabicT5-17GB-large | <center>00:52:17 |<center>72.86/86.00|
74
+
75
+
76
+ Please note that we can further speed up our ArabicT5-Base by increasing the batch size since it could handle larger batch size than other base-scale models due to its hidden layer size (512).
77
+
78
+ # Paper
79
+
80
+ [Generative Approach for Gender-Rewriting Task with ArabicT5](https://aclanthology.org/2022.wanlp-1.55/)
81
+
82
+ # FineTuning our ArabicT5 model on generative and abstractive tasks with FLAX ###
83
+
84
+ [![Open In Colab][COLAB]](https://colab.research.google.com/github/salrowili/ArabicT5/blob/main/FineTuning_ArabicT5_with_FLAX_and_TPU.ipynb)
85
+
86
+ [COLAB]: https://colab.research.google.com/assets/colab-badge.svg
87
+
88
+ ## GitHub Page
89
+
90
+ https://github.com/salrowili/ArabicT5
91
+
92
+
93
+ # Acknowledgment
94
+
95
+ We would like to acknowledge the support we have from The TPU Research Cloud (TRC) team to grant us access to TPUv3 units.
96
+
97
+ # Citation
98
+
99
+ ```bibtex
100
+ @inproceedings{alrowili-shanker-2022-generative,
101
+ title = "Generative Approach for Gender-Rewriting Task with {A}rabic{T}5",
102
+ author = "Alrowili, Sultan and
103
+ Shanker, Vijay",
104
+ booktitle = "Proceedings of the The Seventh Arabic Natural Language Processing Workshop (WANLP)",
105
+ month = dec,
106
+ year = "2022",
107
+ address = "Abu Dhabi, United Arab Emirates (Hybrid)",
108
+ publisher = "Association for Computational Linguistics",
109
+ url = "https://aclanthology.org/2022.wanlp-1.55",
110
+ pages = "491--495",
111
+ abstract = "Addressing the correct gender in generative tasks (e.g., Machine Translation) has been an overlooked issue in the Arabic NLP. However, the recent introduction of the Arabic Parallel Gender Corpus (APGC) dataset has established new baselines for the Arabic Gender Rewriting task. To address the Gender Rewriting task, we first pre-train our new Seq2Seq ArabicT5 model on a 17GB of Arabic Corpora. Then, we continue pre-training our ArabicT5 model on the APGC dataset using a newly proposed method. Our evaluation shows that our ArabicT5 model, when trained on the APGC dataset, achieved competitive results against existing state-of-the-art methods. In addition, our ArabicT5 model shows better results on the APGC dataset compared to other Arabic and multilingual T5 models.",
112
+ }
113
+ ```