License: LGPL Version: 1.2.3 Python versions: 3.6, 3.7, 3.8, 3.9, 3.10, 3.11, 3.12

Silabeador

A Python library for syllabic division and stress detection for Spanish

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. 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 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

pip3 install silabeador

Use

The library provides functions and methods that can be called idependently:

>>> import silabeador

The syllabic division function accepts a string as a single argument and returns a list of syllables.

>>> 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.

>>> silabeador.tonica('Uvulopalatofaringoplastia')
-2

An alternative version accepts a list of syllables and returns the stressed syllable's index.

>>> silabeador.stressed_s(['U', 'vu', 'lo', 'pa', 'la', 'to', 'fa', 'rin', 'go', 'plas', 'tia'])
-2

An object with those values can also be created:

>>> 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.

>>> 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 for feedback, suggestions, or bug reports.

Changelog

  • 1.2.2-1

    • Solved bug qué

  • 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.

@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/>.

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

Project links

Data verified by PyPI on Jul 8, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.2.4.post1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for fsanzl from gravatar.com fsanzl

Credits

Author: Fernando Sanz-Lázaro

GitHub Statistics

Data verified by PyPI on Jul 8, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

GNU Lesser General Public License v2 or later (LGPLv2+) (LGPL)

Requires

Python >=3.5

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

silabeador-1.2.3.tar.gz (21.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

silabeador-1.2.3-py3-none-any.whl (19.1 kB view details)

Uploaded Python 3

File details

Details for the file silabeador-1.2.3.tar.gz.

File metadata

  • Download URL: silabeador-1.2.3.tar.gz
  • Upload date:
  • Size: 21.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for silabeador-1.2.3.tar.gz
Algorithm Hash digest
SHA256 ee2b05d9fa939af752af8d4fc20d2f424b9ac2178ba9f3a3af5f329773a2e629
MD5 49d2e41120c1db666c76f56dd5e94eb3
BLAKE2b-256 ef6c42618b8c0a5623e669c500b8dcbc6e8ae66e9d840e695dd9918c6c48d066

See more details on using hashes here.

Provenance

The following attestation bundles were made for silabeador-1.2.3.tar.gz:

Publisher: python-publish.yml on fsanzl/silabeador

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file silabeador-1.2.3-py3-none-any.whl.

File metadata

  • Download URL: silabeador-1.2.3-py3-none-any.whl
  • Upload date:
  • Size: 19.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for silabeador-1.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 563eb6edefc66aa65a14c06d259be3601692c08073c725c9dd18698050f1f837
MD5 3870a3635e16f3293afe6c9c0e79cdc2
BLAKE2b-256 7a9ea04f94e70425047bc7f6306d8bd2002e1ac6b8b94372a4baba08d096ffe7

See more details on using hashes here.

Provenance

The following attestation bundles were made for silabeador-1.2.3-py3-none-any.whl:

Publisher: python-publish.yml on fsanzl/silabeador

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.2.4.post1

2 files

1.2.4

2 files

This release

1.2.3 This release

2 files

1.2.2.post1

2 files

1.2.1

2 files

1.2.0

2 files

1.1.12

2 files

1.1.11.post6

2 files

1.1.11.post5

2 files

1.1.11.post3

2 files

1.1.11.post2

2 files

1.1.11.post1

2 files

1.1.11

2 files

1.1.10

2 files

1.1.9

2 files

1.1.8

2 files

1.1.7

2 files

1.1.6

2 files

1.1.5

2 files

1.1.4

2 files

1.1.3

2 files

1.1.2

2 files

1.1.1

2 files

1.1.0.post1

2 files

1.1.0

2 files

1.0.7.post2

2 files

1.0.7.post1

2 files

1.0.7

2 files

1.0.6.post1

2 files

1.0.6

2 files

1.0.5.post1

2 files

1.0.5

1 file

1.0.4.post3

2 files

1.0.4.post2

2 files

1.0.4.post1

2 files

1.0.4

2 files

1.0.3

2 files

1.0.2.post17

2 files

1.0.2.post16

2 files

1.0.2.post15

1 file

1.0.2.post14

1 file

1.0.2.post13

1 file

1.0.2.post12

1 file

1.0.2.post11

1 file

1.0.2.post10

1 file

1.0.2.post9

1 file

1.0.2.post8

1 file

1.0.2.post7

1 file

1.0.2.post6

1 file

1.0.2.post5

1 file

1.0.2.post4

1 file

1.0.2.post3

1 file

1.0.2.post2

1 file

1.0.2.post1

1 file

1.0.2

1 file

1.0.1.post2

1 file

1.0.1.post1

2 files

1.0.1

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page