Finnish syllabifier and compound segmenter
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
finnsyll
tests
.gitignore
.travis.yml
CHANGELOG.md
LICENSE.txt
MANIFEST.in
README.rst
ez_setup.py
requirements.txt
setup.cfg
setup.py

README.rst

https://travis-ci.org/tsnaomi/finnsyll.svg?branch=master

FinnSyll

FinnSyll is a Python library that syllabifies words according to Finnish syllabification principles. It is also equipped with a Finnish compound splitter. More details/docs to come.

Installation

$ pip install FinnSyll

Basic usage

First, instantiate a FinnSyll object.

>>> from finnsyll import FinnSyll
>>> f = FinnSyll()

To syllabify:

>>> f.syllabify('runoja')
['ru.no.ja']  # internal syllable boundaries are indicated with '.'

To segment compounds:

>>> f.split('sosiaalidemokraattien')
'sosiaali=demokraattien'  # internal word boundaries are indicated with '='

Optional arguments

The syllabifier can be customized along two different parameters: variation and compound splitting.

variation

Instantiating a FinnSyll object with variation=True (default) will allow the syllabifier to return multiple syllabifications if variation is predicted. When variation=True, the syllabifier will return a list. Setting variation to False will cause the syllabifier to return a string containing the first predicted syllabification.

Variation:

>>> f = FinnSyll(variation=True)
>>> f.syllabify('runoja')
['ru.no.ja']
>>> f.syllabify('vapaus')
['va.pa.us', 'va.paus']

No variation:

>>> f = FinnSyll(variation=False)
>>> f.syllabify('runoja')
'ru.no.ja'
>>> f.syllabify('vapaus')
'va.pa.us'

split_compounds

When instantiating a FinnSyll object with split_compounds=True (default), the syllabifier will first attempt to split the input into constituent words before syllabifying it. This forces the syllabifier to insert a syllable boundary in between identified constituent words. The syllabifier will skip this step if split_compounds is set to False.

Compound splitting:

>>> f = FinnSyll(split_compounds=True)
>>> f.syllabify('rahoituserien')  # rahoitus=erien
['ra.hoi.tus.e.ri.en']

No compound splitting:

>>> f = FinnSyll(split_compounds=False)
>>> f.syllabify('rahoituserien')
['ra.hoi.tu.se.ri.en']  # incorrect