moadel2002 commited on
Commit
f81dee6
·
verified ·
1 Parent(s): fd26718

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. patb_camel.model +3 -0
  5. patb_camel.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: PATB-CamelTB
15
+
16
+ A supervised Arabic dependency parser using the CATiB representation, trained on **PATB and CAMeL Treebank** for **BARECTB: A Dependency Treebank and Parsing Benchmark for Arabic Children’s Texts** (ArabicNLP 2026).
17
+
18
+ This repository contains the original paper-era `patb_camel.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: PATB and CAMeL Treebank.
25
+ - Annotation: CATiB dependency relations.
26
+ - Checkpoint format: native SuPar `.model`; load with CAMeL Parser/SuPar.
27
+
28
+ The original `patb_camel.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
+ | `patb_camel.model` | Original trained parser checkpoint. |
35
+ | `patb_camel.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-PATB-CamelTB",
48
+ filename="patb_camel.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 patb_camel.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
+ 086b4fb610b09ded0024708ecb5c76a440e58e1151805eb97e0bb2f51f0d0d13 patb_camel.model
patb_camel.model ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:086b4fb610b09ded0024708ecb5c76a440e58e1151805eb97e0bb2f51f0d0d13
3
+ size 445277787
patb_camel.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_patb_camel.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/patb_camel.model
45
+ patience: 100
46
+ proj: true
47
+ punct: false
48
+ seed: 1
49
+ steps: 1550
50
+ test: /scratch/ma10074/barectb/experiments/test_patb_camel.conllx
51
+ threads: 16
52
+ train: /scratch/ma10074/barectb/experiments/train_patb_camel.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