Pinyin

This is a Chinese text segmentation library that converts Chinese characters into their phonetic pinyin representation. It functions as a polyphone disambiguation tool, resolving ambiguous pronunciations for multi-sound characters using word segmentation and context analysis, and also serves as a pinyin sorting utility for ordering Chinese strings alphabetically.

The library distinguishes itself through surname-aware pronunciation switching, applying specialized phonetic rules for Chinese surnames with non-standard pronunciations in name contexts. It supports pluggable word segmentation algorithms, allowing users to choose between different segmentation strategies for accuracy or speed, and generates all possible pinyin permutations for strings containing polyphonic characters to support search indexing. The tool also groups pinyin syllables by word boundaries instead of individual characters for more natural phonetic output, and offers flexible output formatting through tone-mark-to-numeric conversion.

Additional capabilities include selecting pinyin style in various formats such as tone marks, numeric tone indicators, or initials-only, and sorting Chinese text alphabetically by converting characters to pinyin and comparing their phonetic representations.

Features

Chinese Character Disambiguations - Converts Chinese characters into their phonetic pinyin representation with polyphonic character support.

Character-to-Pinyin Converters - Provides the core character-to-pinyin conversion with polyphonic support and word-level disambiguation.

HMM Segmenters - Uses word segmentation to reduce polyphone ambiguity by analyzing context for improved pinyin accuracy.

Word-Segmentation-Based Disambiguators - Uses word segmentation to resolve polyphonic character ambiguity by analyzing contextual word boundaries.

Polyphonic Character Handlers - Resolves ambiguous pronunciations for multi-sound Chinese characters using word segmentation and context analysis.

Chinese Language Segmenters - Applies Chinese word segmentation before conversion to reduce polyphonic character ambiguity.

Chinese Character Matchers - Converts Chinese characters into their phonetic pinyin representation with polyphonic character support.

Pre-Conversion Segmenters - Uses word segmentation to improve pinyin accuracy for polyphonic characters by analyzing context.

Phonetic Pronunciation Overrides - Uses specialized pinyin rules for Chinese surnames, ensuring accurate pronunciation in name contexts.

Surname-Aware Pronunciation Overrides - Applies specialized phonetic rules for Chinese surnames with non-standard pronunciations in name contexts.

Pinyin-Based Sorters - Orders Chinese characters or strings based on their pinyin representation for alphabetical sorting.

Polyphone Permutation Generators - Generates all possible pinyin permutations for strings with polyphonic characters to support search indexing.

Pinyin Transliterations - Switches to surname mode to produce more accurate pinyin for Chinese names with special pronunciations.

Pinyin Sorters - Ships a pinyin-based sorting utility for ordering Chinese text alphabetically.

Pinyin Sorting Engines - Implements a sorting engine that orders Chinese strings alphabetically by their pinyin representation.

Surname-Aware Converters - Applies specialized pronunciation rules for Chinese surnames to produce accurate name-specific pinyin output.

Pluggable Segmenter Backends - Provides a pluggable backend architecture for choosing between different word segmentation strategies.

hotoopinyin

Features

Star history