Upload original BARECTB parser checkpoint, configuration, model card, and citation
Browse files- CITATION.bib +7 -0
- README.md +77 -0
- SHA256SUMS +1 -0
- patb_camel.model +3 -0
- 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
|