======================================================================
                       日本語形態素解析システム
                      茶筌 (ChaSen) version 2.03
                            2000年8月6日
======================================================================

0. ファイル・ディレクトリ構成

   README.ja             日本語README(このファイル)
   README                英語README
   CHANGES               変更点
   lib/                  茶筌ライブラリとそのソース
   chasen/               茶筌本体とそのソース
   mkchadic/             システム辞書作成プログラムとそのソース
   prolog/               茶筌を利用するための Prolog インタフェース
   perl/                 茶筌を利用するための Perl モジュール
   doc/                  説明書等
   dic/                  辞書(IPA版)
   qkc/                  Windows用QKCパッケージ

1. インストール

   1. 環境に応じて Makefile の BINDIR, LIBDIR, CC, CFLAGS などの項目を
      書き換えた後 "make" を実行する．これによって各プログラムがコンパ
      イルされる．辞書を作成するためのプログラムは mkchadic/ 以下に，
      茶筌本体の実行ファイルは chasen/chasen に作成される．
      デフォルトでは v-gram 版がコンパイルされる。v-gram 版は従来の
      bi-gram 版とは辞書の形式などが異なる。
      bi-gram 版をコンパイルするには "make bigram" を実行する。
      なお、すでにインストールされている ChaSen 1.51 などの古い
      バージョンも残して使い分けるには、Makefile の CHASEN, LIBDIR を
      CHASEN = chasen2
      LIBDIR = /usr/local/lib/chasen2
      などのように書き換えた後 "make" を実行すればよい。

   2．"make dic" を実行する．これによってシステム辞書が作成される．
      システム辞書作成に要する時間は，辞書の大きさとマシンの性能にも
      よるが，現在の辞書では，SPARCstation20上で2〜3分である．現在の
      標準辞書により最終的に生成されるファイルとその容量は以下の通り．
      dic/chadic.int ... 約9.5MB
      dic/chadic.pat ... 約1.3MB
      dic/chadic.ary ... 約0.9MB

   3. "make install" を実行する．このとき，
      make[1]: [install] Error 1 (ignored)
      というようなメッセージが出力されるかもしれないが無視してよい．
      各ファイルは，デフォルトでは以下の場所にインストールされる．
      /usr/local/bin/chasen            茶筌の実行ファイル
      /usr/local/lib/chasen/chasenrc   chasenrc ファイル
      /usr/local/lib/chasen/mkchadic/  辞書を作成するためのプログラム群
      /usr/local/lib/chasen/dic/       文法・辞書ファイル
      /usr/local/lib/libchasen.a       茶筌ライブラリ
      ただし，以下のものはインストールされない．
      chasen/chasen.el     	       Emacs 用インタフェース
      prolog/*.pl          	       Prolog 用インタフェース
      perl/ChaSen.pm       	       Perl モジュール
      なお、すでに ChaSen 1.51 などの古いバージョンがインストール
      されている場合は、
      # rm -rf /usr/local/lib/chasen
      を実行してファイルを削除してから "make install" を実行するとよい。

   4. ユーザ専用の chasenrc ファイルを利用するには，
      chasenrc をユーザのホームディレクトリに .chasenrc
      (JUMAN 2.0と共用する場合は .jumanrc)という名前でコピーする．
      なお、ChaSen 1.51 と使い分けたいときは .chasen2rc という名前
      でコピーすればよい。
      設定内容についてはユーザーズマニュアルを参照すること．

   Windows 版では，"nmake win" でプログラムをコンパイル，"makedic"
   で辞書をコンパイルする．Microsoft 社の Visual C++ version 5.0
   および 6.0 に付属の nmake.exe と cl.exe で動作を確認している。

2. 使用法

   日本語のテキストファイルを nihongo とする．漢字コードは，日本語EUC
   あるいはJIS(ISO-2022-JP)を受け付ける(Windows版はシフトJISのみ)．
   形態素解析は，

   % chasen nihongo

   と入力することにより実行される．解析結果は標準出力に表示される．端
   末から直接日本語を入力できる場合は，

   % chasen

   と入力し，次に日本語文と改行を入力すれば，形態素解析が実行される．
   出力時の漢字コードは日本語EUCである．

   サーバ・クライアントを用いた解析もできる(Windows版はできない)．
   茶筌サーバを利用するには，まず

   % chasen -s

   と入力してサーバを立ち上げる．次に

   % chasen -Dserver nihongo

   と入力する(server はサーバを立ち上げたマシンのホスト名)と，クライア
   ントが起動し，茶筌サーバに接続して形態素解析を実行する．

   茶筌サーバを利用した解析は，スタンドアロンでの実行に比べ，はじめの
   一文を解析するまでの時間が短いという利点がある．ただし，一度に大量
   のテキストを解析するのはスタンドアロンの方が高速である．

   なお，環境変数 CHASENSERVER に茶筌サーバのホスト名を設定しておくと 
   -D オプションをつけない時でも茶筌サーバに接続して解析を行うように
   なる．

----------------------------------------------------------------------
茶筌の使用方法などの詳細については使用説明書 doc/manual-j.pdf を参照．
茶筌に関する問い合わせは chasen@cl.aist-nara.ac.jp まで．
茶筌ホームページ: http://cl.aist-nara.ac.jp/lab/nlt/chasen/
