parsetc 0.3.2

Parse and convert between different Teochew phonetic spelling schemes.

Parsing tools for Teochew phonetic spelling

Parse and convert between different Teochew phonetic spelling schemes.

Input formats

• Geng'dang Pêng'im 廣東拼音 (gdpi)
• Gaginang Peng'im 家己儂拼音 (ggn)
• Gaginang Peng'im with coda -n allowed (nasalization written with ñ instead) (ggnn)
• Dieghv 潮語 (dieghv); (source)
• Tie-tsiann-hue 潮正會, also known as Tie-lo 潮羅 (tlo); (source)
• Duffus system (duffus), also known as Pe̍h-ūe-jī (PUJ); (source)

Output formats

gdpi, ggnn, tlo, duffus, plus:

• Teochew Sinwenz (sinwz); (source)
• Traditional initial-final categories (15) from 《彙集雅俗通十五音》 also known as 《擊木知音》, based on the analysis by 徐宇航 「《擊木知音》音系之再研究」 (2014)

Orthographic conventions for input text

• Text must be in lower case
• Syllables may be written with or without tone numbers
• Syllables may be combined into words for legibility, i.e. word-segmented writing
• If syllables are combined into words, they must either have tone numbers (e.g. diê5ziu1), or use a syllable separator character (e.g. diê-ziu or pêng'im, or diê5-ziu1). The separator character is either a hyphen or single apostrophe. This is because of ambiguous parsings, e.g. pê-ngi-m instead of pêng-im, which in general can only be dealt with by usage frequency, which is not available.
• If syllable separator characters are used, they must be used consistently. Mixing conventions may cause unexpected parsing errors.

Installation

parsetc requires Python 3 and lark v1.1.

Install latest release with pip from PyPI:

pip install parsetc

If you are interested in latest development version, you can clone this repository and checkout the dev branch, then install with pip from source code:

pip install .

See help message:

parsetc --help

Usage as command line tool

Input text is read line-by-line from STDIN. Output is written to STDOUT.

# output in Tie-lo
echo 'ua2 ain3 oh8 diê5ghe2, ain3 dan3 diê5ziu1 uê7.' | parsetc -i gdpi -o tlo
# all available output romanizations
echo 'ua2 ain3 oh8 diê5ghe2, ain3 dan3 diê5ziu1 uê7.' | parsetc -i gdpi --all

Testing with provided example text:

# Example with tone numbers but no syllable separators
cat examples/dieghv.tones.txt | parsetc -i dieghv --all
# Example with hyphens as syllable separators
cat examples/dieghv.sep.txt | parsetc -i dieghv --all

Usage as a Python module

Import the functions:

from parsetc.parsetc import preprocess, transliterate

Input text should be lower case and without linebreaks. If it uses tone diacritics (tlo and duffus systems), they have to be converted to tone numbers. These preprocessing steps are handled by preprocess. The text can then be converted to the desired system with transliterate.

# Preprocess text with tone diacritics
intext = preprocess("úa àinn ôh tîe-gúr", i="tlo")
# Convert to different phonetic spelling system
outtext = transliterate(intext, i="tlo", o="gdpi")

Applications

parsetc is used to convert Teochew opera transcriptions to different romanization systems for the Learn Teochew Opera website.