mozillazg/python-pinyin
Python Pinyin
python-pinyin is a Python library for transliterating simplified and traditional Chinese characters into phonetic pinyin. It functions as a transliteration system that converts text while supporting tone sandhi and providing utilities to transform pinyin between different formats, such as numeric tones, accent marks, or phonetic initials.
The library features a polyphonic character resolver that analyzes surrounding word context to select the correct pronunciation for characters with multiple sounds. It also includes a customizable dictionary system that allows the extension of default transliteration results using custom single-character and phrase-based phonetic mappings.
The toolset covers broader linguistic operations including the extraction of phonetic components like initials and finals, the application of various phonetic styles, and the handling of unconvertible characters. These capabilities are accessible both as a library and through command-line interfaces for text conversion and tone format translation.
Features
- Pinyin Transliterations - A comprehensive Python library for transliterating simplified and traditional Chinese characters into phonetic pinyin.
- Character-to-Pinyin Converters - Provides a core engine for converting Chinese characters to pinyin with built-in polyphonic character resolution based on word context.
- Polyphonic Character Handlers - Implements mechanisms to resolve characters with multiple pronunciations based on linguistic context.
- Pinyin Style Selectors - Supports transforming pinyin between multiple formats, including numeric tones, accent marks, and initials-only representations.
- Traditional Chinese Support - Converts both simplified and traditional Chinese characters into phonetic pinyin.
- Phonetic Tone Adjustments - Automatically adjusts pinyin tones to reflect natural pronunciation changes based on adjacent syllables.
- Tone Sandhi Rules - Automatically adjusts pinyin tones to reflect natural pronunciation changes based on adjacent syllables.
- Chinese Natural Language Processing - Extracts phonetic components like initials and finals from Chinese text for linguistic analysis.
- Phonetic Component Extractors - Provides utilities to split pinyin strings into their constituent initials and finals according to standard phonetic schemes.
- Pinyin Dictionary Imports - Supports importing external phonetic datasets to customize and expand default pinyin mappings.
- Phrase-Priority Matchers - Ensures semantic accuracy by matching multi-character phrases against the dictionary before processing individual characters.
- Phonetic Formatting Styles - Implements a system to apply diverse transcription styles and pronunciation variants to converted pinyin text.
- Pinyin Notation Converters - Transforms pinyin between various notation styles such as numeric tones and accent marks.
- Natural Language Processing - Listed in the “Natural Language Processing” section of the FunNLP awesome list.
- Lexical Analysis Tools - Library for converting Chinese characters to Pinyin.
- Text Processing - Converts Chinese characters to Pinyin.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
