[](https://opensource.org/licenses/LGPL-2.1)
[](https://pypi.org/project/silabeador/)
[](https://pypi.org/project/silabeador/)
<h2 align="center">Silabeador</h2>
<h3 align="center">A Python library for syllabic division and stress detection for Spanish</h2>
*silabeador* is a Python library of methods and functions for syllabic division and prosodic stress detecting for Spanish.
This library is part of the research project [Sound and Meaning in Spanish Golden Age Literature](https://soundandmeaning.univie.ac.at/). Automatic verse scansion required a syllable separator tolerant to non-Spanish consonant clusters and unusual and non-Spanish diacritics. Other libraries available take for granted that the words are well-constructed according to the Spanish grammar. This is not always the case in particular text types, as in *ü* as regularly used or as a metric diacritic (e.g., *Si-güen-za* vs *crü-el*).
It achieves 99.81 % accuracy when tested against the corpus [EDFU](https://github.com/linhd-postdata/edfu) without exceptions and 98.51 % when applying exceptions such as the implicit hiatus in verbs in *-uar* (*a-cen-tu-ar*) or *-uir* (*re-hu-ir*), or words some nouns (*a-rri-e-ro*).
## Installation
```bash
pip3 install silabeador
```
## Use
The library provides functions and methods that can be called idependently:
```python
>>> import silabeador
```
The syllabic division function accepts a string as a single argument and returns a list of syllables.
```python
>>> silabeador.syllabify('Uvulopalatofaringoplastia')
['U', 'vu', 'lo', 'pa', 'la', 'to', 'fa', 'rin', 'go', 'plas', 'tia']
```
The function to recover the stressed syllable's index takes a string as s single argument and returns the stressed syllable's index.
```python
>>> silabeador.tonica('Uvulopalatofaringoplastia')
-2
```
An alternative version accepts a list of syllables and returns the stressed syllable's index.
```python
>>> silabeador.stressed_s(['U', 'vu', 'lo', 'pa', 'la', 'to', 'fa', 'rin', 'go', 'plas', 'tia'])
-2
```
An object with those values can also be created:
```python
>>> x = silabeador.Syllabification('Uvulopalatofaringoplastia')
>>> x.syllables
['U', 'vu', 'lo', 'pa', 'la', 'to', 'fa', 'rin', 'go', 'plas', 'tia']
>>> x.stress
-2
```
## Description
### Syllabification
The syllabic division follows the principles described by Quilis (2013, 47-49; 2019, 182-192).
Firstly, syllabic nuclei are detected looking for the vowels. Unstressed close vowels join the adjacent vowels in coda or onset to form a diphthong or a triphthong, whilst stressed ones are considered standalone syllabic nuclei. Contiguous consonants are grouped to be parsed apart.
Secondly, consonant clusters are divided considering whether their components are separable and joined to the neighbour nuclei in coda or onset accordingly.
The method *Syllabification()* accepts the following arguments: *word*, *exceptions*, *ipa*, and *h*. Only the first one is compulsory, as the method requires a word to parse. The default value of *exceptions* is *True* and tells whethet the exceptions file should be used. The others' value is *False*. If a IPA transcription instead is used, *ipa* should be *True* to achieve optimal results. The flag *h* marks the behaviour when parsing a cluster *V-C-\<h\>-V*. The default division would be *VC \<h\>V* (*en-hies-to*). If *h* is *True*, the division would be *V C\<h\>V* (*e-nhies-to*).
### Prosodic stress
Prosodic stress detection follows the Spanish rules described by the Real Academia ("tilde"). Proparoxytone words are always orthographically signalled with an acute accent on the nucleic vowel of the antepenultimate syllable. Paroxytones are not marked unless the word ends with *n*, *s* or vowel, in which case they have an acute accent on the nucleic vowel of the penultimate syllable. Oxytone words are only marked if they end in *n*, *s* or vowel with an acute accent on the nucleic vowel of the last syllable. If there is a word without orthographic accent and a recognisable Latin inflection that not appears in Spanish, the prosodic stress is determined according to the latin rules if the quantity of the penultimate syllable can be guessed from the orthography. Otherwise, it tries to guess with the orthographic information available.
### Exceptions to the diphthong rules
Some words such as verbs most verbs in *-uir* and all verbs in *-uar*, as well as adjectives in *-uoso* and nouns such as *guión* or *cliente* do not do a diphthong (Quilis, 2019, 185-186). So they are pronounced */in-fa-tu-ar/*, */a-tri-bu-ir/*, */un-tu-o-so/* o */gui-on/*. Optionally, the processing of these nouns can be dissabled to avoid the hiatus.
```python
>>> silabas('cruel').silabas
['cru', ' el']
>>> silabas('cruel', False).silabas
['cruel']
```
Alternatively, the file *excepciones.lst* can be edited to include or remove words. A morpheme can be used instead of full words (i.e., *acuos* would fit *acuoso*, *acuosa*, *acuosos* and *acuosas*). For convenience, lines can be commented.
## Known problems
Adverbs in *-mente* have primary and secondary stress. Therefore, they must be divided, and each of their parts parsed independently.
## Contributions
Feel free to contribute using the [GitHub Issue Tracker](https://github.com/fsanzl/silabeador/issues) for feedback, suggestions, or bug reports.
## Changelog
* 1.2.1
* Solved crash on 'y'
* 1.2.0
* ChatGPT optimisation and documentation
* 1.1.12
* last-syllable stress for words in [a-u]y without tilde
* 1.1.11-6
* rüin produces ru-ín instead ru-in
* 1.1.11-5
* frue, flue
* 1.1.11-4
* desafiante, desviado, etc.
## How to cite *silabeador*
Authors of scientific papers including results generated using *silabeador* are encouraged to cite the following paper.
```bibtex
@article{SanzLazaroF_RHD2023,
author = {Sanz-Lázaro, Fernando},
title = {Del fonema al verso: una caja de herramientas digitales de escansión teatral},
volume = {8},
date = {2023},
journal = {Revista de Humanidades Digitales},
pages = {74-89},
doi = {https://doi.org/10.5944/rhd.vol.8.2023.37830}
}
```
## Copyright
Copyright (C) 2022 Fernando Sanz-Lázaro <<fsanzl@gmail.com>>
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library. If not, see <[https://www.gnu.org/licenses/](https://www.gnu.org/licenses/)>.
## References
Quilis, Antonio, *Tratado de fonología y fonétia españolas*. 1993. Madrid, Gredos, 2019.
---, *Métrica española*. 1984. Barcelona, Ariel, 1996.
"tilde". *Diccionario panhispánico de dudas*, 2005. https://www.rae.es/dpd/tilde
Raw data
{
"_id": null,
"home_page": "https://github.com/fsanzl/silabeador",
"name": "silabeador",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": null,
"keywords": null,
"author": "Fernando Sanz-L\u00e1zaro",
"author_email": "fsanzl@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d1/a0/88cf3535555ae444801bd1fc947d1e4ff96e41ce2bdb9d01b3771d9307e7/silabeador-1.2.1.tar.gz",
"platform": null,
"description": "[](https://opensource.org/licenses/LGPL-2.1)\n[](https://pypi.org/project/silabeador/)\n[](https://pypi.org/project/silabeador/)\n\n\n<h2 align=\"center\">Silabeador</h2>\n\n<h3 align=\"center\">A Python library for syllabic division and stress detection for Spanish</h2>\n\n*silabeador* is a Python library of methods and functions for syllabic division and prosodic stress detecting for Spanish.\nThis library is part of the research project [Sound and Meaning in Spanish Golden Age Literature](https://soundandmeaning.univie.ac.at/). Automatic verse scansion required a syllable separator tolerant to non-Spanish consonant clusters and unusual and non-Spanish diacritics. Other libraries available take for granted that the words are well-constructed according to the Spanish grammar. This is not always the case in particular text types, as in *\u00fc* as regularly used or as a metric diacritic (e.g., *Si-g\u00fcen-za* vs *cr\u00fc-el*).\n\n\nIt achieves 99.81 % accuracy when tested against the corpus [EDFU](https://github.com/linhd-postdata/edfu) without exceptions and 98.51 % when applying exceptions such as the implicit hiatus in verbs in *-uar* (*a-cen-tu-ar*) or *-uir* (*re-hu-ir*), or words some nouns (*a-rri-e-ro*).\n\n## Installation\n\n```bash\npip3 install silabeador\n```\n\n## Use\n\nThe library provides functions and methods that can be called idependently:\n\n\n```python\n>>> import silabeador\n```\n\nThe syllabic division function accepts a string as a single argument and returns a list of syllables.\n\n```python\n>>> silabeador.syllabify('Uvulopalatofaringoplastia')\n['U', 'vu', 'lo', 'pa', 'la', 'to', 'fa', 'rin', 'go', 'plas', 'tia']\n```\n\nThe function to recover the stressed syllable's index takes a string as s single argument and returns the stressed syllable's index.\n\n```python\n>>> silabeador.tonica('Uvulopalatofaringoplastia')\n-2\n```\n\nAn alternative version accepts a list of syllables and returns the stressed syllable's index.\n\n```python\n>>> silabeador.stressed_s(['U', 'vu', 'lo', 'pa', 'la', 'to', 'fa', 'rin', 'go', 'plas', 'tia'])\n-2\n```\n\nAn object with those values can also be created:\n\n```python\n>>> x = silabeador.Syllabification('Uvulopalatofaringoplastia')\n>>> x.syllables\n['U', 'vu', 'lo', 'pa', 'la', 'to', 'fa', 'rin', 'go', 'plas', 'tia']\n>>> x.stress\n-2\n``` \n\n\n## Description\n\n### Syllabification\n\nThe syllabic division follows the principles described by Quilis (2013, 47-49; 2019, 182-192).\n\nFirstly, syllabic nuclei are detected looking for the vowels. Unstressed close vowels join the adjacent vowels in coda or onset to form a diphthong or a triphthong, whilst stressed ones are considered standalone syllabic nuclei. Contiguous consonants are grouped to be parsed apart.\n\nSecondly, consonant clusters are divided considering whether their components are separable and joined to the neighbour nuclei in coda or onset accordingly.\n\nThe method *Syllabification()* accepts the following arguments: *word*, *exceptions*, *ipa*, and *h*. Only the first one is compulsory, as the method requires a word to parse. The default value of *exceptions* is *True* and tells whethet the exceptions file should be used. The others' value is *False*. If a IPA transcription instead is used, *ipa* should be *True* to achieve optimal results. The flag *h* marks the behaviour when parsing a cluster *V-C-\\<h\\>-V*. The default division would be *VC \\<h\\>V* (*en-hies-to*). If *h* is *True*, the division would be *V C\\<h\\>V* (*e-nhies-to*).\n\n\n### Prosodic stress\n\nProsodic stress detection follows the Spanish rules described by the Real Academia (\"tilde\"). Proparoxytone words are always orthographically signalled with an acute accent on the nucleic vowel of the antepenultimate syllable. Paroxytones are not marked unless the word ends with *n*, *s* or vowel, in which case they have an acute accent on the nucleic vowel of the penultimate syllable. Oxytone words are only marked if they end in *n*, *s* or vowel with an acute accent on the nucleic vowel of the last syllable. If there is a word without orthographic accent and a recognisable Latin inflection that not appears in Spanish, the prosodic stress is determined according to the latin rules if the quantity of the penultimate syllable can be guessed from the orthography. Otherwise, it tries to guess with the orthographic information available.\n\n### Exceptions to the diphthong rules\n\nSome words such as verbs most verbs in *-uir* and all verbs in *-uar*, as well as adjectives in *-uoso* and nouns such as *gui\u00f3n* or *cliente* do not do a diphthong (Quilis, 2019, 185-186). So they are pronounced */in-fa-tu-ar/*, */a-tri-bu-ir/*, */un-tu-o-so/* o */gui-on/*. Optionally, the processing of these nouns can be dissabled to avoid the hiatus.\n\n```python\n>>> silabas('cruel').silabas\n['cru', ' el']\n>>> silabas('cruel', False).silabas\n['cruel']\n```\nAlternatively, the file *excepciones.lst* can be edited to include or remove words. A morpheme can be used instead of full words (i.e., *acuos* would fit *acuoso*, *acuosa*, *acuosos* and *acuosas*). For convenience, lines can be commented.\n\n## Known problems\n\nAdverbs in *-mente* have primary and secondary stress. Therefore, they must be divided, and each of their parts parsed independently.\n\n\n## Contributions\n\nFeel free to contribute using the [GitHub Issue Tracker](https://github.com/fsanzl/silabeador/issues) for feedback, suggestions, or bug reports.\n\n## Changelog\n\n* 1.2.1\n * Solved crash on 'y'\n\n* 1.2.0\n * ChatGPT optimisation and documentation\n\n* 1.1.12\n * last-syllable stress for words in [a-u]y without tilde\n\n* 1.1.11-6\n * r\u00fcin produces ru-\u00edn instead ru-in\n\n* 1.1.11-5\n * frue, flue\n\n* 1.1.11-4\n * desafiante, desviado, etc.\n\n## How to cite *silabeador*\n\nAuthors of scientific papers including results generated using *silabeador* are encouraged to cite the following paper.\n\n```bibtex\n@article{SanzLazaroF_RHD2023, \n author = {Sanz-L\u00e1zaro, Fernando},\n title = {Del fonema al verso: una caja de herramientas digitales de escansi\u00f3n teatral},\n volume = {8},\n date = {2023},\n journal = {Revista de Humanidades Digitales},\n pages = {74-89},\n doi = {https://doi.org/10.5944/rhd.vol.8.2023.37830}\n}\n```\n\n## Copyright\n\nCopyright (C) 2022 Fernando Sanz-L\u00e1zaro <<fsanzl@gmail.com>>\n\nThis library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.\n\nThis library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.\n\nYou should have received a copy of the GNU Lesser General Public License along with this library. If not, see <[https://www.gnu.org/licenses/](https://www.gnu.org/licenses/)>.\n\n## References\n\nQuilis, Antonio, *Tratado de fonolog\u00eda y fon\u00e9tia espa\u00f1olas*. 1993. Madrid, Gredos, 2019.\n\n---, *M\u00e9trica espa\u00f1ola*. 1984. Barcelona, Ariel, 1996. \n\n\"tilde\". *Diccionario panhisp\u00e1nico de dudas*, 2005. https://www.rae.es/dpd/tilde\n",
"bugtrack_url": null,
"license": "LGPL",
"summary": "A Python library of methods and functions for syllabic division and prosodic stress detecting for Spanish",
"version": "1.2.1",
"project_urls": {
"Homepage": "https://github.com/fsanzl/silabeador",
"Source": "https://github.com/fsanzl/silabeador/",
"Tracker": "https://github.com/fsanzl/silabeador/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ce943c72b5a4fa6c0cc63527e906c51ce758adc4fe9124afe90d3fe4dbda9e98",
"md5": "60bcde1d053ea3a6267868620384fb01",
"sha256": "bd231c198948c799f0c1bf65608d5554d7dac47f60e0d525831a92062fe10754"
},
"downloads": -1,
"filename": "silabeador-1.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "60bcde1d053ea3a6267868620384fb01",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 19034,
"upload_time": "2024-10-06T13:02:42",
"upload_time_iso_8601": "2024-10-06T13:02:42.890635Z",
"url": "https://files.pythonhosted.org/packages/ce/94/3c72b5a4fa6c0cc63527e906c51ce758adc4fe9124afe90d3fe4dbda9e98/silabeador-1.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d1a088cf3535555ae444801bd1fc947d1e4ff96e41ce2bdb9d01b3771d9307e7",
"md5": "6b673dd442b616a460947764a7ca1ffb",
"sha256": "13a51263e1ccf9679d363d71b61bcaf213d6195120c3c36893281d8a36d184a0"
},
"downloads": -1,
"filename": "silabeador-1.2.1.tar.gz",
"has_sig": false,
"md5_digest": "6b673dd442b616a460947764a7ca1ffb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.5",
"size": 21511,
"upload_time": "2024-10-06T13:02:44",
"upload_time_iso_8601": "2024-10-06T13:02:44.628989Z",
"url": "https://files.pythonhosted.org/packages/d1/a0/88cf3535555ae444801bd1fc947d1e4ff96e41ce2bdb9d01b3771d9307e7/silabeador-1.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-06 13:02:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "fsanzl",
"github_project": "silabeador",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "silabeador"
}
JSON
