--- license: cc-by-sa-4.0 language: - hy tags: - dependency-parsing - combo - universal-dependencies datasets: - universal_dependencies model-name: Combo Nlp Xlm Roberta Base Armenian Armtdp Ud2.17 pipeline_tag: token-classification --- # COMBO-NLP Model for Armenian ## Model Description This is a Armenian-language model based on [combo-nlp](https://pypi.org/project/combo-nlp/), an open-source natural language preprocessing system. It performs: - sentence segmentation (via [combo-seg](https://pypi.org/project/combo-seg/)) - tokenisation (via [combo-seg](https://pypi.org/project/combo-seg/)) - part-of-speech tagging - morphological analysis - lemmatisation - dependency parsing The Armenian model uses ``FacebookAI/xlm-roberta-base`` as its base encoder and is trained on [UD_Armenian-ArmTDP](https://github.com/UniversalDependencies/UD_Armenian-ArmTDP) (UD v2.17). ## Evaluation Evaluation was performed on the UD_Armenian-ArmTDP test split using the standard [CoNLL 2018 eval script](https://universaldependencies.org/conll18/conll18_ud_eval.py). Two evaluation rows are reported: - **Full-text (F1)**: raw text is segmented by [combo-seg](https://pypi.org/project/combo-seg/), then parsed and compared against gold — measures end-to-end pipeline performance including segmentation quality. - **Aligned accuracy**: accuracy on correctly segmented (aligned) tokens — measures parsing quality on tokens that were correctly identified by the segmenter. ### Morphosyntactic Tagging | Metric | Tokens | Sentences | Words | UPOS | XPOS | UFeats | AllTags | Lemmas | | ------ | ------ | --------- | ----- | ---- | ---- | ------ | ------- | ------ | | Full-text (F1) | 99.62 | 90.05 | 98.19 | 96.46 | 98.19 | 90.43 | 89.90 | 95.77 | | Aligned accuracy | 0.00 | 0.00 | 0.00 | 98.24 | 100.00 | 92.09 | 91.56 | 97.53 | ### Dependency Parsing | Metric | UAS | LAS | CLAS | MLAS | BLEX | | ------ | --- | --- | ---- | ---- | ---- | | Full-text (F1) | 88.84 | 85.32 | 82.71 | 72.94 | 80.47 | | Aligned accuracy | 90.48 | 86.90 | 84.12 | 74.18 | 81.84 | ## Usage Install the library from PyPI (assuming you have a virtual environment created): ```bash pip install combo-nlp ``` The [combo-seg](https://pypi.org/project/combo-seg/) segmenter (used to split and tokenise raw text) is installed automatically as a dependency of `combo-nlp`, so no extra install step is needed. ```python from combo import COMBO # Load a pre-trained model with the corresponding combo-seg segmenter nlp = COMBO("Armenian") # Parse raw text (handles sentence splitting + tokenization) result = nlp("Արագ շագանակագույն աղվեսը թսկնում է ծույլ շան հատուկին.") # Inspect results for sentence in result: for token in sentence: print(f"{token.form:<15} {token.lemma:<15} {token.upos:<8} head={token.head} {token.deprel}") ``` Refer to the combo-nlp documentation for installation and usage instructions: - [https://pypi.org/project/combo-nlp/](https://pypi.org/project/combo-nlp/) - [https://pypi.org/project/combo-seg/](https://pypi.org/project/combo-seg/) ## License The training data license: cc-by-sa-4.0 is derived from the Universal Dependencies treebank. For the full license terms of each treebank, please refer to the corresponding `LICENSE.txt` file in the treebank repository: - [UD_Armenian-ArmTDP LICENSE.txt](https://github.com/UniversalDependencies/UD_Armenian-ArmTDP/blob/master/LICENSE.txt) ## Citation If you use this model, please cite: Ulewicz, M., Jabłońska, M., Klimaszewski, M., Przybyła, P., Pszenny, Ł., Rybak, P., Wiącek, M., & Wróblewska, A. (2026). *COMBO-NLP Models Trained on UD v2.17*. Zenodo. https://doi.org/10.5281/zenodo.19650523 ```bibtex @software{combo_nlp_2026, author = {Ulewicz, Michał and Jabłońska, Maja and Klimaszewski, Mateusz and Przybyła, Piotr and Pszenny, Łukasz and Rybak, Piotr and Wiącek, Martyna and Wróblewska, Alina}, title = {{COMBO-NLP} Models Trained on {UD} v2.17}, year = {2026}, publisher = {Zenodo}, doi = {10.5281/zenodo.19650523}, url = {https://doi.org/10.5281/zenodo.19650523} } ``` ## Resources - combo-nlp: [https://pypi.org/project/combo-nlp/](https://pypi.org/project/combo-nlp/) - combo-seg: [https://pypi.org/project/combo-seg/](https://pypi.org/project/combo-seg/) - UD_Armenian-ArmTDP: [https://github.com/UniversalDependencies/UD_Armenian-ArmTDP](https://github.com/UniversalDependencies/UD_Armenian-ArmTDP)