Instructions to use dicta-il/dictabert-joint with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use dicta-il/dictabert-joint with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("feature-extraction", model="dicta-il/dictabert-joint", trust_remote_code=True)# Load model directly from transformers import AutoTokenizer, AutoModel tokenizer = AutoTokenizer.from_pretrained("dicta-il/dictabert-joint", trust_remote_code=True) model = AutoModel.from_pretrained("dicta-il/dictabert-joint", trust_remote_code=True, device_map="auto") - Notebooks
- Google Colab
- Kaggle
DictaBERT: A State-of-the-Art BERT Suite for Modern Hebrew
State-of-the-art language model for Hebrew, released here.
This is the fine-tuned model for the joint parsing of the following tasks:
- Prefix Segmentation
- Morphological Disabmgiuation
- Lexicographical Analysis (Lemmatization)
- Syntactical Parsing (Dependency-Tree)
- Named-Entity Recognition
A live demo of the model with instant visualization of the syntax tree can be found here.
For a faster model, you can use the equivalent bert-tiny model for this task here.
For the bert-base models for other tasks, see here.
The model currently supports 3 types of output:
JSON: The model returns a JSON object for each sentence in the input, where for each sentence we have the sentence text, the NER entities, and the list of tokens. For each token we include the output from each of the tasks.
model.predict(..., output_style='json')UD: The model returns the full UD output for each sentence, according to the style of the Hebrew UD Treebank.
model.predict(..., output_style='ud')UD, in the style of IAHLT: This model returns the full UD output, with slight modifications to match the style of IAHLT. This differences are mostly granularity of some dependency relations, how the suffix of a word is broken up, and implicit definite articles. The actual tagging behavior doesn't change.
model.predict(..., output_style='iahlt_ud')
If you only need the output for one of the tasks, you can tell the model to not initialize some of the heads, for example:
model = AutoModel.from_pretrained('dicta-il/dictabert-joint', trust_remote_code=True, do_lex=False)
The list of options are: do_lex, do_syntax, do_ner, do_prefix, do_morph.
Sample usage:
from transformers import AutoModel, AutoTokenizer
tokenizer = AutoTokenizer.from_pretrained('dicta-il/dictabert-joint')
model = AutoModel.from_pretrained('dicta-il/dictabert-joint', trust_remote_code=True)
model.eval()
sentence = 'ืืฉื ืช 1948 ืืฉืืื ืืคืจืื ืงืืฉืื ืืช ืืืืืืื ืืคืืกืื ืืชืืช ืืืชืืืืืช ืืืื ืืช ืืืื ืืคืจืกื ืืืืจืื ืืืืืจืืกืืืื'
print(model.predict([sentence], tokenizer, output_style='json')) # see below for other return formats
Output:
[
{
"text": "ืืฉื ืช 1948 ืืฉืืื ืืคืจืื ืงืืฉืื ืืช ืืืืืืื ืืคืืกืื ืืชืืช ืืืชืืืืืช ืืืื ืืช ืืืื ืืคืจืกื ืืืืจืื ืืืืืจืืกืืืื",
"tokens": [
{
"token": "ืืฉื ืช",
"syntax": {
"word": "ืืฉื ืช",
"dep_head_idx": 2,
"dep_func": "obl",
"dep_head": "ืืฉืืื"
},
"seg": [
"ื",
"ืฉื ืช"
],
"lex": "ืฉื ื",
"morph": {
"token": "ืืฉื ืช",
"pos": "NOUN",
"feats": {
"Gender": "Fem",
"Number": "Sing"
},
"prefixes": [
"ADP"
],
"suffix": false
}
},
{
"token": "1948",
"syntax": {
"word": "1948",
"dep_head_idx": 0,
"dep_func": "compound",
"dep_head": "ืืฉื ืช"
},
"seg": [
"1948"
],
"lex": "1948",
"morph": {
"token": "1948",
"pos": "NUM",
"feats": {},
"prefixes": [],
"suffix": false
}
},
{
"token": "ืืฉืืื",
"syntax": {
"word": "ืืฉืืื",
"dep_head_idx": -1,
"dep_func": "root",
"dep_head": "ืืืืืจืืกืืืื"
},
"seg": [
"ืืฉืืื"
],
"lex": "ืืฉืืื",
"morph": {
"token": "ืืฉืืื",
"pos": "VERB",
"feats": {
"Gender": "Masc",
"Number": "Sing",
"Person": "3",
"Tense": "Past"
},
"prefixes": [],
"suffix": false
}
},
{
"token": "ืืคืจืื",
"syntax": {
"word": "ืืคืจืื",
"dep_head_idx": 2,
"dep_func": "nsubj",
"dep_head": "ืืฉืืื"
},
"seg": [
"ืืคืจืื"
],
"lex": "ืืคืจืื",
"morph": {
"token": "ืืคืจืื",
"pos": "PROPN",
"feats": {},
"prefixes": [],
"suffix": false
}
},
{
"token": "ืงืืฉืื",
"syntax": {
"word": "ืงืืฉืื",
"dep_head_idx": 3,
"dep_func": "flat",
"dep_head": "ืืคืจืื"
},
"seg": [
"ืงืืฉืื"
],
"lex": "ืงืืฉืื",
"morph": {
"token": "ืงืืฉืื",
"pos": "PROPN",
"feats": {},
"prefixes": [],
"suffix": false
}
},
{
"token": "ืืช",
"syntax": {
"word": "ืืช",
"dep_head_idx": 6,
"dep_func": "case",
"dep_head": "ืืืืืืื"
},
"seg": [
"ืืช"
],
"lex": "ืืช",
"morph": {
"token": "ืืช",
"pos": "ADP",
"feats": {},
"prefixes": [],
"suffix": false
}
},
{
"token": "ืืืืืืื",
"syntax": {
"word": "ืืืืืืื",
"dep_head_idx": 2,
"dep_func": "obj",
"dep_head": "ืืฉืืื"
},
"seg": [
"ืืืืืืื"
],
"lex": "ืืืืื",
"morph": {
"token": "ืืืืืืื",
"pos": "NOUN",
"feats": {
"Gender": "Masc",
"Number": "Plur"
},
"prefixes": [],
"suffix": "PRON",
"suffix_feats": {
"Gender": "Masc",
"Number": "Sing",
"Person": "3"
}
}
},
{
"token": "ืืคืืกืื",
"syntax": {
"word": "ืืคืืกืื",
"dep_head_idx": 6,
"dep_func": "nmod",
"dep_head": "ืืืืืืื"
},
"seg": [
"ื",
"ืคืืกืื"
],
"lex": "ืคืืกืื",
"morph": {
"token": "ืืคืืกืื",
"pos": "NOUN",
"feats": {
"Gender": "Masc",
"Number": "Sing"
},
"prefixes": [
"ADP"
],
"suffix": false
}
},
{
"token": "ืืชืืช",
"syntax": {
"word": "ืืชืืช",
"dep_head_idx": 7,
"dep_func": "compound",
"dep_head": "ืืคืืกืื"
},
"seg": [
"ืืชืืช"
],
"lex": "ืืชืืช",
"morph": {
"token": "ืืชืืช",
"pos": "NOUN",
"feats": {
"Gender": "Fem",
"Number": "Sing"
},
"prefixes": [],
"suffix": false
}
},
{
"token": "ืืืชืืืืืช",
"syntax": {
"word": "ืืืชืืืืืช",
"dep_head_idx": 7,
"dep_func": "conj",
"dep_head": "ืืคืืกืื"
},
"seg": [
"ืื",
"ืชืืืืืช"
],
"lex": "ืชืืืื",
"morph": {
"token": "ืืืชืืืืืช",
"pos": "NOUN",
"feats": {
"Gender": "Fem",
"Number": "Plur"
},
"prefixes": [
"CCONJ",
"ADP"
],
"suffix": false
}
},
{
"token": "ืืืื ืืช",
"syntax": {
"word": "ืืืื ืืช",
"dep_head_idx": 9,
"dep_func": "compound",
"dep_head": "ืืืชืืืืืช"
},
"seg": [
"ื",
"ืืื ืืช"
],
"lex": "ืืืื ืืช",
"morph": {
"token": "ืืืื ืืช",
"pos": "NOUN",
"feats": {
"Gender": "Fem",
"Number": "Sing"
},
"prefixes": [
"DET"
],
"suffix": false
}
},
{
"token": "ืืืื",
"syntax": {
"word": "ืืืื",
"dep_head_idx": 2,
"dep_func": "conj",
"dep_head": "ืืฉืืื"
},
"seg": [
"ื",
"ืืื"
],
"lex": "ืืื",
"morph": {
"token": "ืืืื",
"pos": "VERB",
"feats": {
"Gender": "Masc",
"Number": "Sing",
"Person": "3",
"Tense": "Past"
},
"prefixes": [
"CCONJ"
],
"suffix": false
}
},
{
"token": "ืืคืจืกื",
"syntax": {
"word": "ืืคืจืกื",
"dep_head_idx": 11,
"dep_func": "xcomp",
"dep_head": "ืืืื"
},
"seg": [
"ืืคืจืกื"
],
"lex": "ืคืจืกื",
"morph": {
"token": "ืืคืจืกื",
"pos": "VERB",
"feats": {},
"prefixes": [],
"suffix": false
}
},
{
"token": "ืืืืจืื",
"syntax": {
"word": "ืืืืจืื",
"dep_head_idx": 12,
"dep_func": "obj",
"dep_head": "ืืคืจืกื"
},
"seg": [
"ืืืืจืื"
],
"lex": "ืืืืจ",
"morph": {
"token": "ืืืืจืื",
"pos": "NOUN",
"feats": {
"Gender": "Masc",
"Number": "Plur"
},
"prefixes": [],
"suffix": false
}
},
{
"token": "ืืืืืจืืกืืืื",
"syntax": {
"word": "ืืืืืจืืกืืืื",
"dep_head_idx": 13,
"dep_func": "amod",
"dep_head": "ืืืืจืื"
},
"seg": [
"ืืืืืจืืกืืืื"
],
"lex": "ืืืืืจืืกืื",
"morph": {
"token": "ืืืืืจืืกืืืื",
"pos": "ADJ",
"feats": {
"Gender": "Masc",
"Number": "Plur"
},
"prefixes": [],
"suffix": false
}
}
],
"root_idx": 2,
"ner_entities": [
{
"phrase": "1948",
"label": "TIMEX"
},
{
"phrase": "ืืคืจืื ืงืืฉืื",
"label": "PER"
}
]
}
]
You can also choose to get your response in UD format:
sentence = 'ืืฉื ืช 1948 ืืฉืืื ืืคืจืื ืงืืฉืื ืืช ืืืืืืื ืืคืืกืื ืืชืืช ืืืชืืืืืช ืืืื ืืช ืืืื ืืคืจืกื ืืืืจืื ืืืืืจืืกืืืื'
print(model.predict([sentence], tokenizer, output_style='ud'))
Results:
[
[
"# sent_id = 1",
"# text = ืืฉื ืช 1948 ืืฉืืื ืืคืจืื ืงืืฉืื ืืช ืืืืืืื ืืคืืกืื ืืชืืช ืืืชืืืืืช ืืืื ืืช ืืืื ืืคืจืกื ืืืืจืื ืืืืืจืืกืืืื",
"1-2\tืืฉื ืช\t_\t_\t_\t_\t_\t_\t_\t_",
"1\tื\tื\tADP\tADP\t_\t2\tcase\t_\t_",
"2\tืฉื ืช\tืฉื ื\tNOUN\tNOUN\tGender=Fem|Number=Sing\t4\tobl\t_\t_",
"3\t1948\t1948\tNUM\tNUM\t\t2\tcompound:smixut\t_\t_",
"4\tืืฉืืื\tืืฉืืื\tVERB\tVERB\tGender=Masc|Number=Sing|Person=3|Tense=Past\t0\troot\t_\t_",
"5\tืืคืจืื\tืืคืจืื\tPROPN\tPROPN\t\t4\tnsubj\t_\t_",
"6\tืงืืฉืื\tืงืืฉืื\tPROPN\tPROPN\t\t5\tflat\t_\t_",
"7\tืืช\tืืช\tADP\tADP\t\t8\tcase:acc\t_\t_",
"8-10\tืืืืืืื\t_\t_\t_\t_\t_\t_\t_\t_",
"8\tืืืืื_\tืืืืื\tNOUN\tNOUN\tGender=Masc|Number=Plur\t4\tobj\t_\t_",
"9\t_ืฉื_\tืฉื\tADP\tADP\t_\t10\tcase\t_\t_",
"10\t_ืืื\tืืื\tPRON\tPRON\tGender=Masc|Number=Sing|Person=3\t8\tnmod:poss\t_\t_",
"11-12\tืืคืืกืื\t_\t_\t_\t_\t_\t_\t_\t_",
"11\tื\tื\tADP\tADP\t_\t12\tcase\t_\t_",
"12\tืคืืกืื\tืคืืกืื\tNOUN\tNOUN\tGender=Masc|Number=Sing\t8\tnmod\t_\t_",
"13\tืืชืืช\tืืชืืช\tNOUN\tNOUN\tGender=Fem|Number=Sing\t12\tcompound:smixut\t_\t_",
"14-16\tืืืชืืืืืช\t_\t_\t_\t_\t_\t_\t_\t_",
"14\tื\tื\tCCONJ\tCCONJ\t_\t16\tcc\t_\t_",
"15\tื\tื\tADP\tADP\t_\t16\tcase\t_\t_",
"16\tืชืืืืืช\tืชืืืื\tNOUN\tNOUN\tGender=Fem|Number=Plur\t12\tconj\t_\t_",
"17-18\tืืืื ืืช\t_\t_\t_\t_\t_\t_\t_\t_",
"17\tื\tื\tDET\tDET\t_\t18\tdet\t_\t_",
"18\tืืื ืืช\tืืืื ืืช\tNOUN\tNOUN\tGender=Fem|Number=Sing\t16\tcompound:smixut\t_\t_",
"19-20\tืืืื\t_\t_\t_\t_\t_\t_\t_\t_",
"19\tื\tื\tCCONJ\tCCONJ\t_\t20\tcc\t_\t_",
"20\tืืื\tืืื\tVERB\tVERB\tGender=Masc|Number=Sing|Person=3|Tense=Past\t4\tconj\t_\t_",
"21\tืืคืจืกื\tืคืจืกื\tVERB\tVERB\t\t20\txcomp\t_\t_",
"22\tืืืืจืื\tืืืืจ\tNOUN\tNOUN\tGender=Masc|Number=Plur\t21\tobj\t_\t_",
"23\tืืืืืจืืกืืืื\tืืืืืจืืกืื\tADJ\tADJ\tGender=Masc|Number=Plur\t22\tamod\t_\t_"
]
]
Citation
If you use DictaBERT-joint in your research, please cite MRL Parsing without Tears: The Case of Hebrew
BibTeX:
@misc{shmidman2024mrl,
title={MRL Parsing Without Tears: The Case of Hebrew},
author={Shaltiel Shmidman and Avi Shmidman and Moshe Koppel and Reut Tsarfaty},
year={2024},
eprint={2403.06970},
archivePrefix={arXiv},
primaryClass={cs.CL}
}
License
This work is licensed under a Creative Commons Attribution 4.0 International License.
- Downloads last month
- 14,000
