cjk-semantic-split 0.1.0

Recursive atomic decomposition of CJK characters with 9-grid spatial encoding

cjk-semantic-split

Recursive atomic decomposition of CJK characters with 9-grid spatial position encoding.

pip install cjk-semantic-split

from chinese_decompose import decompose

decompose("踩")
# '踩[30]:足[60]:爪[80]:木'

decompose("囚")
# '囚[90]:囗[0]:人'

decompose("踩好", as_tree=True)
# [DecompositionTree('踩'), DecompositionTree('好')]

Position Encoding

Every component sits at a 2-digit position code: cardinals (10/20/30/40), single-cell corners (50/60/70/80), 4-cell layout strips (14/16/34/36), or surround envelopes (90–99). See the design spec for full details.

CLI

python -m chinese_decompose 踩                 # DSL string
python -m chinese_decompose 踩 --format json   # JSON output
python -m chinese_decompose --self-test        # coverage report

Data Sources

Decomposition data is bundled for offline use. Coverage extends across four tiers:

• Tier 1 (Unihan kIDS): ~21k chars
• Tier 2 (wikimedia Commons): ~22k chars
• Tier 3 (next-layer harvest): ~80k chars
• Tier 4 (manual patches): dispute-case overrides

Last-wins resolution: patches > l3 > l2 > l1.

Configuration

from chinese_decompose import set_primitives

set_primitives({"木", "火", "水", ...})  # process-local override

License

MIT — see LICENSE.