======================================================================

                       日本語形態素解析システム
                 茶筌(ChaSen) version 2.1 for Windows
                         作成: 1999年12月15日
                         改訂: 2000年09月24日

======================================================================

----------------------------------------------------------------------
改訂履歴
----------------------------------------------------------------------

1999.12.17 「4.6 大きなテキストを扱う場合」を追加
2000.09.24 「5 VShellの使い方」を追加
           「7.1 辞書コンパイル」を追加
           その他の関連項目を変更


----------------------------------------------------------------------
目次
----------------------------------------------------------------------

0 システム要件

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

2 パッケージの内容

3 インストール方法

4 WinCha2000(wincha.exe)の使い方

    4.1 基本操作
    4.2 表示項目の設定
    4.3 文の入力
    4.4 解析結果の保存
    4.5 編集
    4.6 大きなテキストを扱う場合

5 WVShell(wvs.exe)の使い方

    5.1 基本操作
    5.2 複数のテキストファイルに対する形態素解析の実行

6 茶筌(chasen.exe)の使い方

    5.1 pathの設定
    5.2 chasen.exeでの解析法

7 辞書について

    7.1 辞書コンパイル
    7.2 IPADIC2.4について

8 困ったときには

9 著作権および使用条件について


----------------------------------------------------------------------
0 システム要件
----------------------------------------------------------------------

○オペレーティングシステム

   Microsoft Windows 95 日本語版
             Windows 98 日本語版
             Windows Me 日本語版
             Windows NT 4.0 日本語版
             Windows 2000 日本語版


○メモリ容量

   オペレーティングシステムが必要とする最低容量 + 16Mバイト以上


○インストールに必要な空きディスク容量

   60Mバイト以上


○ディスプレイ解像度

   VGA(640x480)以上 ※SVGA(800x600)以上を推奨※


----------------------------------------------------------------------
1 ファイル・ディレクトリ構成
----------------------------------------------------------------------

注:(*)印のついたファイルはインストール後に削除可能です

○ 配布ファイル名

   chasen21.exe     自己解凍型インストールプログラム(*)


○ 配布パッケージに含まれるファイル

   setup.exe        自動インストール用セットアッププログラム(*)
   SETUP.LST        setup.exe用リストファイル(*)
   WinCha.CAB       セットアップ用CABファイル(*)


○ インストールされるファイル

   README.TXT       このファイル
   chasen.exe       形態素解析エンジン 茶筌 実行ファイル (Console Application)
   wincha.exe       WinCha2000 (GUI Application)
   wvs.exe          WVShell (GUI Application)
   wvs*.bat         WVShell用バッチファイル

   dic\             辞書ディレクトリ(ipadic2.4)
   dic\chasenrc     茶筌リソースファイル
   dic\*.cha        文法ファイル
   dic\chadic.*     コンパイル済み形態素辞書ファイル

   dll\             DLL版ディレクトリ
   dll\chasen.dll   DLL版 形態素解析エンジン
   dll\chadll.exp   chasen.dll エクスポートファイル
   dll\chadll.h     chasen.dll ヘッダファイル
   dll\chadll.lib   chasen.dll ライブラリファイル
   dll\dlltest.c    DLL版のサンプルソース

   doc\             ドキュメントディレクトリ
   doc\CHANGES      UNIX版 変更履歴
   doc\README       UNIX版 README(英語版)
   doc\README.ja    UNIX版 README(日本語版)
   doc\manual-j.pdf 茶筌ドキュメント(日本語版)
   doc\manual.pdf   茶筌ドキュメント(英語版)

   mkchadic\        辞書コンパイラディレクトリ
   mkchadic\*.exe   辞書コンパイル実行ファイル

   source\wincha\   wincha.exeソースディレクトリ(VisualBasic6.0)
   source\wvs\      wvs.exeソースディレクトリ(VisualBasic6.0)


○ 実行時に作成されるファイル

   input.tmp        解析用一時ファイル(入力)
   output.tmp       解析用一時ファイル(出力)
   wincha.ini       wincha.exe用イニシャルファイル
   wvs.ini          wvs.exe用イニシャルファイル


----------------------------------------------------------------------
2 パッケージの内容
----------------------------------------------------------------------

本パッケージに含まれるのは，

   形態素解析エンジン                       chasen.exe
   形態素解析用GUI                          wincha.exe
   形態素解析用簡易GUIシェル                wvs.exe
   コンパイル済み形態素辞書                 dic\
   DLL版形態素解析エンジン(サポート対象外)  dll\
   茶筌ドキュメント                         doc\
   ソースファイル                           source\

です．

茶筌ホームページからは下記パッケージもダウンロードできます．

   茶筌ソースコード
   形態素辞書ファイル

詳細は http://cl.aist-nara.ac.jp/lab/nlt/chasen/ をご覧ください。


----------------------------------------------------------------------
3 インストール方法
----------------------------------------------------------------------

自己解凍ファイル chasen21.exe を実行してインストールを行います．

(1)エクスプローラーなどで chasen21.exe をダブルクリックして自己解凍プ
   ログラムを起動します．

(2)「一時ファイルの展開先を指定してください」というウィンドウが出たら
   適切なディレクトリを指定してから「OK」をクリックしてください．ディ
   レクトリ名は，DOS/Vの場合はデフォルトの「C:\Temp」のままで，NECの
   PC-9821シリーズの場合は「A:\Temp」などに設定してから「OK」をクリッ
   クしてください．

(3)次にセットアッププログラムが起動され「茶筌 version 2.1 for Windows
   セットアップ」という画面が現れます．「OK」をクリックするとシステム
   ファイルの追加・更新の処理が行われます．システムを更新するため再起
   動が必要な場合もあります．画面の指示に従って操作してください．再起
   動を行った場合，起動後に(2)で展開先に指定したディレクトリにある
   setup.exeをダブルクリックして再度セットアッププログラムを実行してく
   ださい．

(4)「セットアップを開始するには次のボタンをクリックしてください．」と
   いう画面でインストール先を設定します．通常はデフォルト表示されてい
   るディレクトリにインストールします．画面左のマシンのアイコンをクリ
   ックしてセットアップを継続します．

(5)「茶筌 version 2.1 for Windows のセットアップが完了しました．」と
   いう画面が出たらインストールは完了です．スタートメニューのプログラ
   ムに「茶筌 version 2.1」グループが作成されていますので，その中にあ
   るWinCha2000を実行してください．


----------------------------------------------------------------------
4 WinCha2000(wincha.exe)の使い方
----------------------------------------------------------------------

4.1 基本操作

   WinCha2000では，画面右上の文エリアにある文字列を形態素解析し，結果
   を画面下部の形態素エリアに表示します．

   形態素解析は文エリアに文字列を入力してから，画面左上にある次の3つの
   ボタンを用いて行います．

『全文解析』

    文エリアに入力されている文字列の形態素解析を行い，結果を形態素エリ
    アに表示します．


『部分解析』

    マウスで文エリアの一部を範囲指定してから「部分解析」ボタンをクリッ
    クすると，指定した範囲だけが解析されます．


『クリア』

    文エリアと形態素エリアをクリアし，内容を破棄します．


4.2 表示項目の設定

   文エリアと形態素エリアの間にあるチェックボックスで，形態素エリアに
   表示する項目を設定できます．

   各項目の区切り文字の指定は「区切り」ドロップダウンリストから選択す
   るか，直接「区切り」に文字を入力することで可能です．

   さらに高度な茶筌オプションの指定を行うには，形態素エリア上部の「オ
   プション」を用います．「オプション」には履歴が保持されているので，
   必要に応じてドロップダウンリストから履歴を選択して再利用してくださ
   い．茶筌オプションについては doc\manual-j.pdf を参照してください。


4.3 文の入力

   文エリアの文字列を改行で区切ることで一度に複数の文を解析することが
   できます．文エリアへの文字列の入力には，次の5つの方法があります．

○ 直接入力

   マウスで文エリアをクリックして，キーボードから直接文字列を入力し
   ます．


○「ファイル」メニューの「テキストファイルを開く」(Ctrl+O)

   テキストファイルの内容を文エリアに表示します．以前の文エリアの内
   容は破棄されます．


○ エクスプローラーからファイルをドラッグ&ドロップ

   WinCha2000にテキストファイルをドラッグ&ドロップすると，文エリア
   の末尾にファイルの内容を追加できます．同時に複数のファイルをドロ
   ップすることもできます．


○ 他のアプリケーションのデータをドラッグ&ドロップ

   WinCha2000に他のアプリケーション(Word等)からテキストをドラッグ&
   ドロップすると，文エリアの末尾にテキストを追加できます．


○ クリップボードから貼り付け

   文エリアにカーソルがある状態で「編集」メニューの「貼り付け」を実
   行すると，カーソル位置にクリップボードの内容を挿入できます．また
   「編集」メニューの「文を貼り付け」を実行すると，文エリアをクリア
   してからクリップボードの内容を貼り付けます．


4.4 解析結果の保存

   形態素エリアのデータをファイルに保存することができます．保存には次
   の2つの方法があります．

○「ファイル」メニューの「解析結果を名前を付けて保存」(Ctrl+S)

   新規にファイルを作成して形態素エリアの内容を保存します．一度，保
   存を実行すると，以後「解析結果をファイルに追加」の対象となります．


○「ファイル」メニューの「解析結果をファイルに追加」(Ctrl+W)

   既存ファイルの末尾に形態素エリアの内容を追加します．追加の対象と
   なるのは，直前に保存したファイルです．そのようなファイルが存在し
   ない場合には，追加ファイルの指定を行うためのダイアログが表示され
   ます．また，明示的に追加ファイルを指定するには，「ファイル」メニ
   ューの「追加ファイルの指定」を実行します．


4.5 編集

   他のWindowsアプリケーションと同様に，クリップボードを用いた切り取り
   (Ctrl+X)，コピー(Ctrl+C)，貼り付け(Ctrl+V)のアクションが可能です．
   元に戻す(Ctrl+Z)，やり直し(Ctrl+Y)では2レベルの訂正が可能です．
   上記以外にも便利な機能がいくつかありますので，編集メニューを参照し
   てください．


4.6 大きなテキストを扱う場合

   WinCha2000はVisualBasic6.0で作成されています．そのため，テキストボ
   ックス内に表示可能な文字数の上限は，VisualBasic6.0の仕様に依存しま
   す．この文字数の上限より大きなテキストを扱う場合は，画面への表示を
   行わずに解析や保存を行えるよう，ダイアログボックスを表示します．
   複数のテキストファイルを一度に解析する場合には、次で述べるWVShell
   が便利です。


----------------------------------------------------------------------
5 WVShell(wvs.exe)の使用法
----------------------------------------------------------------------

5.1 基本操作

   WVShellはコマンドの実行をVisualに操作可能な汎用シェルツールです。
   コマンドプロンプトの使い方に慣れていない人や、多数のファイルに対し
   てコマンドを効率よく実行したい場合におすすめです。

   コマンドラインに相当するのが画面上部にあるドロップダウンリストです。
   画面中央にあるリストボックス『Source Files』には、Drag&Dropでコマン
   ドによる操作の対象となるファイルを集めます。実行結果を置くディレク
   トリは画面右に表示されている『Destination Directory』で選択します。
   画面左上の『Do!』をクリックすると、『Source Files』の各ファイルに対
   してコマンドが順次実行されます。

   コマンドラインでは次の3つの変数が使えます。

   %f    Source Files のファイル名
   %i    Source Files のディレクトリ名(フルパス)
   %o    Destination Directory のディレクトリ名(フルパス)

   また、コマンドラインではリダイレクトを用いることができます。

   なお、『Synchronized』がチェックされている場合、コマンドは逐次的に
   実行され、チェックされていない場合は並列実行されます。


5.2 複数のテキストファイルに対する形態素解析の実行

(1)コマンドラインを以下のように設定します。

   chasen -o "%o\%f.cha" "%i\%f"

(2)Source Filesに解析対象とするファイルをドラッグします。

   注: エクスプローラーからDrag&Dropできます

(3)Destination Directoryに出力ファイルを置くディレクトリを指定します。

   注: 新しいディレクトリを作成する場合は Mkdir を使うと便利です

(4)Do!をクリックします。

   注: コマンド実行中はアイコンが砂時計になります


----------------------------------------------------------------------
6 茶筌(chasen.exe)の使用法
----------------------------------------------------------------------

6.1 pathの設定

   コマンドプロンプトからchasen.exeを実行するには，環境変数PATHに茶筌
   のインストール先ディレクトリのフルパスを追加する必要があります．こ
   の節ではPATHの設定方法の概要を説明します．

(1) Windows95,98,Meの場合

   Windowsの起動ドライブにautoexec.batというファイルがあります．
   以下，autoexe.batへのPATHの追加について説明します．
   autoexec.batの編集にはメモ帳などのエディタを用います．
   もしautoexec.batが無い場合は，新規に作成してから以下の操作を行って
   ください．

○ autoexec.bat中に既にPATH設定の行がある場合

   PATHエントリの最後に;と茶筌ディレクトリのフルパスを追加します．

   例:
      path=c:\windows;c:\windows\system

   という行がある場合，次のように変更．

      path=c:\windows;c:\windows\system;"c:\program files\chasen21"

   上書き保存を実行してから再起動を行います．


○ autoexec.bat中にPATH設定の行がない場合

   WinCha2000のディレクトリ名をフルパスで指定します．通常はwindows
   のシステムディレクトリにもpathを通す必要があるので以下のように
   指定します．

      path=c:\windows;c:\windows\system;"c:\program files\chasen21"

   名前を付けて保存で AUTOEXE.BAT を指定して，再起動を行います．


(2) WindowsNT,2000の場合

   デスクトップのマイコンピュータを右クリックして「プロパティ」をクリ
   ックし，「環境」タブを選択します．システム環境変数の中のpathをクリ
   ックして，値の末尾に;に続けて茶筌ディレクトリのフルパスを入力し，
   「設定」ボタンをクリックしてから「OK」をクリックします．最後に再起
   動を行ってください．


6.2 chasen.exeでの解析法

日本語のテキストファイルをsentence.txtとします．漢字コードは日本語シフ
トJISでなければなりません．コマンドプロンプト(コンソール)で，

   chasen sentence.txt

のように，ファイルをコマンドライン引数に列挙するか，もしくは，

   chasen < sentence.txt

のようにファイルを標準入力にリダイレクトすると，解析結果が標準出力(コ
ンソール)に表示されます．

解析結果をファイルに保存するには，

   chasen sentence.txt > result.txt

のように，'>'を用いて標準出力をファイルにリダイレクトするか，

   chasen -o result.txt sentence.txt

のように，-oオプションを用いて出力ファイルを指定します．

また，コマンドプロンプトで直接日本語を入力できる場合は，

   chasen

を実行して，次に日本語文と改行を入力すれば，解析が実行されます．
この場合，chasenを終了するには，Ctrl+Zを入力します．


----------------------------------------------------------------------
7 辞書について
----------------------------------------------------------------------

7.1 辞書コンパイル

   本パッケージに付属の辞書コンパイラが作成する辞書ファイルはUNIX版と
   互換性がありますが、コンパイルの対象となる辞書ソースファイルは日本
   語シフトJISエンコードである必要があります。別パッケージで配布される
   IPADICをコンパイルする場合は、本パッケージがインストールされている
   ディレクトリにあるdicの下にIPADICのパッケージを展開し、予めQKCなど
   のコマンドで辞書ソースファイルのエンコードをEUCからシフトJISに変換
   してから辞書コンパイルを実行してください。
   辞書コンパイルはdic\makedic.batを使って行います。

辞書コンパイルの例:

   cd "\program files\chasen21\dic"
   tar zxvf ipadic.tar.gz
   qkc -s -m chasenrc *.cha *.dic
   makedic

   辞書コンパイルに成功すると以下のように表示されます。

   chasen dictionary compiled successfully.


7.2 ipadic2.4について

   本パッケージに付属する辞書(ipadic2.4)は，従来，茶筌とともに配布され
   ていた辞書とは互換性がありません．本辞書を使用するためには，茶筌
   version 2.1 for Windows を用いる必要があります．また，各種定義ファ
   イル名が従来の chasen.* から *.cha に変更されています．

   ipadic1.0は，情報処理振興事業協会による独創的先進的情報技術に係わ
   る研究開発「日本語ディクテーション基本ソフトウェアの開発」の一環と
   して開発されました．ipadic2.xは，これを元に改良を行ったものです．

   本辞書では，読みフィールドと発音フィールドの表記があります．読みが
   仮名遣いに基づくもの，発音が実際の読み方に基づくものになっています
   ．読み，発音ともすべてカタカナ表記です．発音の表記法はNHK日本語発音
   アクセント辞典(新版)に基づいています．

   また，同一形態素に対して複数の読みが考えられる場合に，それらを別形
   態素とはせずに，同一形態素の読みフィールドに複数の読みを併記してい
   ます (例：今日 {キョウ/コンニチ})．解析結果に全ての読みの候補を出力
   する場合には -F オプション引数に %y0 を与えます．%y では読みの第1候
   補のみが出力されます．発音についても %a0 で全候補が出力され，%a で
   第1候補が出力されます．


----------------------------------------------------------------------
8 困ったときには
----------------------------------------------------------------------

○マニュアル

   茶筌の使用方法などの詳細については使用説明書 doc/manual-j.pdf を参
   照してください．Unix用マニュアルのため，一部Windows版とは異なる点が
   あります．ご了承ください．


○問い合わせ先

   茶筌に関するお問い合わせは，chasen@cl.aist-nara.ac.jp まで．


○ホームページ

   最新の情報が茶筌ホームページから入手できます．
   http://cl.aist-nara.ac.jp/lab/nlt/chasen.html


----------------------------------------------------------------------
9 著作権および使用条件について
----------------------------------------------------------------------

茶筌システムは，広く自然言語処理研究に資するため無償のソフトウェアとし
て開発されたものである．茶筌の著作権は，奈良先端科学技術大学院大学情報
科学研究科自然言語処理学講座(松本研究室)が保持する．本ソフトウェアの使
用，改変，再配布については，特に制限を課すことはしないが，再配布につい
ては，次の事項を条件とする．

○本ソフトウェアがその原形あるいは修正された形で再配布される場合は，再
  配布されるソフトウェアに茶筌が使用されていることを明記すること．

○再配布されるソフトウェアに，著作権に関する本節の記述と使用説明書の表
  紙裏のページの著作権に関する但し書きを必ず含むこと．

なお，本ソフトウェアの著作権者である奈良先端科学技術大学院大学は，原形
あるいは改変された形で配布された本ソフトウェアに関連して生じる一切の損
失に対して保証の責を負わないこととする．


