# Tibetan Phonetics Engine
## Description
The goal of this code is to provide a library to:
- implement the conversion of a Tibetan Unicode word into IPA, according to different schemes / dialects
- implement some conversions between IPA and phonetics readable by people with various language backgrounds (Chinese, English, etc.)
The primary focus of this library is litterary pronounciation, ideally representing how an umze would pronounce a traditional text, but contributions for other uses are welcome. We also do not handle Sanskrit transliteration (this can be done through custom exceptions lists).
Note that this library integrates no segmenter and needs to be applied on each word separately. You can use it in combination with [pybo](https://github.com/Esukhia/pybo/) to get the phonetics of full sentences.
## Phonetics methods
We currently provide two phonetics schemes:
#### Manual of Standard Tibetan (by Tournadre)
#### Colloquial Amdo Tibetan (by Kuo-ming Sung and Lha Byams Rgyal)
## Outputs
Apart from raw IPA, we provide the following output possibilities:
#### Chinese phonetics
The Chinese is produced by a streamlined phonetic scheme in order to match the Mandarin phonology (vowels have been simplified and most of the Tibetan suffixes removed).
To produce the final output, we first transform the generated IPA into [Zhuyin](https://en.wikipedia.org/wiki/Bopomofo), and then the Zhuyin into Traditional Chinese characters, with a manually built correspondance list.
## Installation
```
pip install bophono
```
## API
To get the IPA for a word according to the `MST` scheme:
```python
import bophono
# see PhonStateMST.py for other options
options = {
'aspirateLowTones': True
}
mstconverter = bophono.UnicodeToApi(schema="MST", options = options)
mstipa = mstconverter.get_api("སྐུ")
print(mstipa) # kú
```
Note that you must first segment your text in words and then convert each word.
## Changes
See [CHANGELOG.md](CHANGELOG.md).
## License
The Python code is Copyright (C) 2018-2023 Esukhia, provided under [MIT License](LICENSE). See [CONTRIBUTORS.md](CONTRIBUTORS.md) for a list of authors and contributors.
Raw data
{
"_id": null,
"home_page": "https://github.com/Esukhia/bophono",
"name": "bophono",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": "",
"keywords": "phonetics IPA tibetan",
"author": "Esukhia development team",
"author_email": "roux.elie@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d7/98/aa3e2526e84dc59cae2641c463294e14a249976141df364bfe166e77f54d/bophono-0.2.0.tar.gz",
"platform": null,
"description": "# Tibetan Phonetics Engine\n\n## Description\n\nThe goal of this code is to provide a library to:\n- implement the conversion of a Tibetan Unicode word into IPA, according to different schemes / dialects\n- implement some conversions between IPA and phonetics readable by people with various language backgrounds (Chinese, English, etc.)\n\nThe primary focus of this library is litterary pronounciation, ideally representing how an umze would pronounce a traditional text, but contributions for other uses are welcome. We also do not handle Sanskrit transliteration (this can be done through custom exceptions lists).\n\nNote that this library integrates no segmenter and needs to be applied on each word separately. You can use it in combination with [pybo](https://github.com/Esukhia/pybo/) to get the phonetics of full sentences.\n\n## Phonetics methods\n\nWe currently provide two phonetics schemes:\n\n#### Manual of Standard Tibetan (by Tournadre)\n\n#### Colloquial Amdo Tibetan (by Kuo-ming Sung and Lha Byams Rgyal)\n\n## Outputs\n\nApart from raw IPA, we provide the following output possibilities:\n\n#### Chinese phonetics\n\nThe Chinese is produced by a streamlined phonetic scheme in order to match the Mandarin phonology (vowels have been simplified and most of the Tibetan suffixes removed).\n\nTo produce the final output, we first transform the generated IPA into [Zhuyin](https://en.wikipedia.org/wiki/Bopomofo), and then the Zhuyin into Traditional Chinese characters, with a manually built correspondance list.\n\n## Installation\n\n```\npip install bophono\n```\n\n## API\n\nTo get the IPA for a word according to the `MST` scheme:\n\n```python\nimport bophono\n\n# see PhonStateMST.py for other options\noptions = {\n 'aspirateLowTones': True\n}\n\nmstconverter = bophono.UnicodeToApi(schema=\"MST\", options = options)\nmstipa = mstconverter.get_api(\"\u0f66\u0f90\u0f74\")\nprint(mstipa) # ku\u0301\n```\n\nNote that you must first segment your text in words and then convert each word.\n\n## Changes\n\nSee [CHANGELOG.md](CHANGELOG.md).\n\n## License\n\nThe Python code is Copyright (C) 2018-2023 Esukhia, provided under [MIT License](LICENSE). See [CONTRIBUTORS.md](CONTRIBUTORS.md) for a list of authors and contributors.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python utils for Tibetan phonetics in different dialects",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/Esukhia/bophono",
"Source": "https://github.com/Esukhia/bophono",
"Tracker": "https://github.com/Esukhia/bophono/issues"
},
"split_keywords": [
"phonetics",
"ipa",
"tibetan"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "43acc374611303c29b76ff2981cc8c4b7830a7b58fe247194e235860ef29edb3",
"md5": "201e947334c94cd717c408a6fb64e2cf",
"sha256": "0a992dbf3823f6852279fc8ad9ce6d41bc783a884d48f00df1df596056e81f0d"
},
"downloads": -1,
"filename": "bophono-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "201e947334c94cd717c408a6fb64e2cf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 34337,
"upload_time": "2023-06-18T07:03:23",
"upload_time_iso_8601": "2023-06-18T07:03:23.350432Z",
"url": "https://files.pythonhosted.org/packages/43/ac/c374611303c29b76ff2981cc8c4b7830a7b58fe247194e235860ef29edb3/bophono-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d798aa3e2526e84dc59cae2641c463294e14a249976141df364bfe166e77f54d",
"md5": "0b2428c19127cab8e2868c909a33fe4d",
"sha256": "7871e20ef0e87c4e7561186ee99d97d091f3204d28859f940a12ba319507bb29"
},
"downloads": -1,
"filename": "bophono-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "0b2428c19127cab8e2868c909a33fe4d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 28784,
"upload_time": "2023-06-18T07:03:24",
"upload_time_iso_8601": "2023-06-18T07:03:24.815273Z",
"url": "https://files.pythonhosted.org/packages/d7/98/aa3e2526e84dc59cae2641c463294e14a249976141df364bfe166e77f54d/bophono-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-18 07:03:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Esukhia",
"github_project": "bophono",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "bophono"
}
JSON
