moadel2002 commited on
Commit
6a77f03
·
verified ·
1 Parent(s): 5f37355

Upload original BARECTB parser checkpoint, configuration, model card, and citation

Browse files
Files changed (5) hide show
  1. CITATION.bib +7 -0
  2. README.md +77 -0
  3. SHA256SUMS +1 -0
  4. barectb.model +3 -0
  5. barectb.model.yaml +60 -0
CITATION.bib ADDED
@@ -0,0 +1,7 @@
 
 
 
 
 
 
 
 
1
+ @inproceedings{elmadani-etal-2026-barectb,
2
+ title = {{BARECTB}: A Dependency Treebank and Parsing Benchmark for Arabic Children's Texts},
3
+ author = {Elmadani, Khalid N. and Adel, Mohamed and AbuOdeh, Muhammed and Faraj, Reem and El-Gizuli, Jamila and Taha, Hanada and Habash, Nizar},
4
+ booktitle = {Proceedings of ArabicNLP 2026},
5
+ address = {Budapest, Hungary},
6
+ year = {2026}
7
+ }
README.md ADDED
@@ -0,0 +1,77 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ language:
3
+ - ar
4
+ base_model: CAMeL-Lab/bert-base-arabic-camelbert-msa
5
+ tags:
6
+ - dependency-parsing
7
+ - arabic
8
+ - catib
9
+ - barectb
10
+ - supar
11
+ - pytorch
12
+ ---
13
+
14
+ # CamelParser-BARECTB: BARECTB
15
+
16
+ A supervised Arabic dependency parser using the CATiB representation, trained on **BARECTB** for **BARECTB: A Dependency Treebank and Parsing Benchmark for Arabic Children’s Texts** (ArabicNLP 2026).
17
+
18
+ This repository contains the original paper-era `barectb.model` checkpoint. It is the same checkpoint distributed in the paper repository's `models/` directory. The later expanded 160K experiments use separate checkpoints.
19
+
20
+ ## Model
21
+
22
+ - Encoder: [CAMeLBERT-MSA](https://huggingface.co/CAMeL-Lab/bert-base-arabic-camelbert-msa), as recorded in the checkpoint's training configuration.
23
+ - Dependency parser: BERT-encoded biaffine parser implemented with [SuPar](https://github.com/yzhangcs/parser) and used through [CAMeL Parser](https://github.com/CAMeL-Lab/camel_parser).
24
+ - Training condition: BARECTB.
25
+ - Annotation: CATiB dependency relations.
26
+ - Checkpoint format: native SuPar `.model`; load with CAMeL Parser/SuPar.
27
+
28
+ The original `barectb.model.yaml` accompanies the checkpoint. Its historical training paths are preserved as provenance; inference uses the downloaded checkpoint.
29
+
30
+ ## Files
31
+
32
+ | File | Description |
33
+ | --- | --- |
34
+ | `barectb.model` | Original trained parser checkpoint. |
35
+ | `barectb.model.yaml` | Original training configuration. |
36
+ | `SHA256SUMS` | Checkpoint SHA-256 checksum. |
37
+ | `CITATION.bib` | Paper citation. |
38
+
39
+ ## Inference with CAMeL Parser
40
+
41
+ Follow the installation instructions in the [CAMeL Parser main branch](https://github.com/CAMeL-Lab/camel_parser/tree/main), including its Python and CAMeL Tools data requirements. From that checkout, download this checkpoint into its `models/` directory:
42
+
43
+ ```python
44
+ from huggingface_hub import hf_hub_download
45
+
46
+ hf_hub_download(
47
+ repo_id="CAMeL-Lab/camelparser-barectb-BARECTB",
48
+ filename="barectb.model",
49
+ local_dir="models",
50
+ )
51
+ ```
52
+
53
+ Then parse raw Arabic text:
54
+
55
+ ```bash
56
+ python text_to_conll_cli.py -f text -m barectb.model -s "القطة نائمة."
57
+ ```
58
+
59
+ Use `-i input.txt` for a file of sentences. The optional MSA-S31 morphology database requires the separate installation and access steps documented upstream.
60
+
61
+ ## Scope
62
+
63
+ This checkpoint supports the paper's supervised Arabic dependency parsing experiments. Use the matching original BARECTB splits when reproducing that benchmark. Training corpora and morphology resources are separate from this model repository.
64
+
65
+ ## Citation
66
+
67
+ Elmadani, Khalid N., Mohamed Adel, Muhammed AbuOdeh, Reem Faraj, Jamila El-Gizuli, Hanada Taha and Nizar Habash. BARECTB: A Dependency Treebank and Parsing Benchmark for Arabic Children’s Texts. In Proceedings of ArabicNLP 2026, Budapest, Hungary, 2026.
68
+
69
+ ```bibtex
70
+ @inproceedings{elmadani-etal-2026-barectb,
71
+ title = {{BARECTB}: A Dependency Treebank and Parsing Benchmark for Arabic Children's Texts},
72
+ author = {Elmadani, Khalid N. and Adel, Mohamed and AbuOdeh, Muhammed and Faraj, Reem and El-Gizuli, Jamila and Taha, Hanada and Habash, Nizar},
73
+ booktitle = {Proceedings of ArabicNLP 2026},
74
+ address = {Budapest, Hungary},
75
+ year = {2026}
76
+ }
77
+ ```
SHA256SUMS ADDED
@@ -0,0 +1 @@
 
 
1
+ ad6084fea414743b0df1b96c3c9d65fca91da4df98f697d7ef183749a8d705b8 barectb.model
barectb.model ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:ad6084fea414743b0df1b96c3c9d65fca91da4df98f697d7ef183749a8d705b8
3
+ size 445276633
barectb.model.yaml ADDED
@@ -0,0 +1,60 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ amp: false
2
+ batch_size: 5000
3
+ bert: CAMeL-Lab/bert-base-arabic-camelbert-msa
4
+ bert_pad_index: null
5
+ bert_pooling: mean
6
+ binarize: false
7
+ bos_index: 2
8
+ buckets: 32
9
+ build: false
10
+ cache: false
11
+ char_pad_index: null
12
+ checkpoint: false
13
+ clip: 5.0
14
+ dev: /scratch/ma10074/barectb/experiments/dev_barectb.conllx
15
+ device: '0'
16
+ dist: ddp
17
+ embed: glove-6b-100
18
+ encoder: bert
19
+ encoder_dropout: 0.1
20
+ epochs: 10
21
+ eps: 1.0e-08
22
+ even: false
23
+ feat: null
24
+ fix_len: 20
25
+ local_rank: 0
26
+ lr: 5.0e-05
27
+ lr_rate: 10
28
+ max_len: null
29
+ min_freq: 2
30
+ mix_dropout: 0.0
31
+ mlp_dropout: 0.33
32
+ mode: train
33
+ mu: 0.9
34
+ n_arc_mlp: 500
35
+ n_bert_layers: 4
36
+ n_chars: null
37
+ n_rel_mlp: 100
38
+ n_rels: 9
39
+ n_tags: null
40
+ n_words: 30000
41
+ nu: 0.999
42
+ pad_index: 0
43
+ partial: false
44
+ path: /scratch/ma10074/barectb/models/barectb.model
45
+ patience: 100
46
+ proj: true
47
+ punct: false
48
+ seed: 1
49
+ steps: 160
50
+ test: /scratch/ma10074/barectb/experiments/test_barectb.conllx
51
+ threads: 16
52
+ train: /scratch/ma10074/barectb/experiments/train_barectb.conllx
53
+ tree: true
54
+ unk_index: 1
55
+ update_steps: 4
56
+ verbose: true
57
+ wandb: false
58
+ warmup: 0.1
59
+ weight_decay: 0
60
+ workers: 0