Skip to main content

Classical Chinese to Modern Japanese Translator

Project description

Current PyPI packages


Classical Chinese to Modern Japanese Translator, working on Universal Dependencies.

Basic usage

>>> import udkundoku
>>> lzh=udkundoku.load()
>>> s=lzh("不入虎穴不得虎子")
>>> t=udkundoku.translate(s)
>>> print(t)
# text = 虎の穴に入らずして虎の子を得ず
1			NOUN	n,名詞,主体,動物	_	3	nmod	_	Gloss=tiger|SpaceAfter=No
2		_	ADP	_	_	1	case	_	SpaceAfter=No
3			NOUN	n,名詞,固定物,地形	Case=Loc	5	obj	_	Gloss=cave|SpaceAfter=No
4		_	ADP	_	_	3	case	_	SpaceAfter=No
5	入ら		VERB	v,動詞,行為,移動	_	11	advcl	_	Gloss=enter|SpaceAfter=No
6	ずして		AUX	v,副詞,否定,無界	Polarity=Neg	5	advmod	_	Gloss=not|SpaceAfter=No
7			NOUN	n,名詞,主体,動物	_	9	nmod	_	Gloss=tiger|SpaceAfter=No
8		_	ADP	_	_	7	case	_	SpaceAfter=No
9			NOUN	n,名詞,,関係	_	11	obj	_	Gloss=child|SpaceAfter=No
10		_	ADP	_	_	9	case	_	SpaceAfter=No
11			VERB	v,動詞,行為,得失	_	0	root	_	Gloss=get|SpaceAfter=No
12			AUX	v,副詞,否定,無界	Polarity=Neg	11	advmod	_	Gloss=not|SpaceAfter=No

>>> print(t.sentence())

>>> print(s.to_tree())
 <     advmod
 ─┴─┐< advcl
 <   nmod
 ─┘<  obj
 <    advmod
 ─┴─┬─┘ root
 <    nmod
 ─┘<   obj

>>> print(t.to_tree())
 ─┐<     nmod(体言による連体修飾語)
 <      case(格表示)
 ─┬─┘<   obj(目的語)
 <      case(格表示)
 ─┬───┘< advcl(連用修飾節)
 <      advmod(連用修飾語)
 ─┐<    nmod(体言による連体修飾語)
 <     case(格表示)
 ─┬─┘<  obj(目的語)
 <     case(格表示)
 ─┬───┴─┘ root()
 <       advmod(連用修飾語)

udkundoku.load() is an alias for udkanbun.load() of UD-Kanbun. udkundoku.translate() is a transcriptive converter from Classical Chinese (under Universal Dependencies of UD-Kanbun) into Modern Japanese (under Universal Dependencies of UniDic2UD). udkundoku.reorder() is called to rearrange Classical Chinese into Japanese word-order inside udkundoku.translate(). to_tree() and to_svg() are borrowed from those of UD-Kanbun.

You can simply use udkundoku on the command line:

echo 不入虎穴不得虎子 | udkundoku -j

HTTP-server usage

python -m udkundoku.server 5000

Try to connect with your local browser. Input a Classical Chinese sentence there and push 解析-button (at least) three times.


Installation for Linux

Tar-ball is available for Linux, and is installed by default when you use pip:

pip install udkundoku

旧仮名口語UniDic is automatically downloaded for UniDic2UD.

Installation for Cygwin

Make sure to get gcc-g++ python37-pip python37-devel packages, and then:

pip3.7 install udkundoku

Use python3.7 command in Cygwin instead of python.

Installation for Jupyter Notebook (Google Colaboratory)

!pip install udkundoku


Koichi Yasuoka (安岡孝一)


Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for udkundoku, version 1.0.7
Filename, size File type Python version Upload date Hashes
Filename, size udkundoku-1.0.7.tar.gz (19.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page