マイニング処理ツールの作り方 のバックアップ(No.12)

• バックアップ一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• マイニング処理ツールの作り方 へ行く。
  • 1 (2013-04-14 (日) 23:05:35)
  • 2 (2013-04-14 (日) 23:30:02)
  • 3 (2013-04-15 (月) 17:38:01)
  • 4 (2013-04-28 (日) 17:52:40)
  • 5 (2013-05-12 (日) 10:12:43)
  • 6 (2013-11-08 (金) 01:11:25)
  • 7 (2013-11-12 (火) 12:06:24)
  • 8 (2014-11-13 (木) 13:42:18)
  • 9 (2015-05-13 (水) 21:58:09)
  • 10 (2015-11-29 (日) 22:29:13)
  • 11 (2018-11-14 (水) 12:35:54)
  • 12 (2018-11-21 (水) 11:43:01)

---

GUIを作成しない簡易版の作り方は以下のリンク先へ †

• マイニング処理ツールの作り方(簡易版)
  

マイニング処理ツール †

• 入力テキストのデータ（テキストデータ）を入力として，入力テキストに関する処理結果をデータとして生成し，可視化ツールに出力します．
• マイニング処理ツール作成用ツールキット（処理ツール作成用ソース）

マイニング処理ツール作成の概要 †

• マイニング処理ツール作成用の、マイニングモジュールクラス(MiningModule)を継承(extends)してクラスを作成します。
• 出力データを作成するための処理は，miningOperations() メソッドの中から、呼び出される形で記述します。(オーバーライド）
• パネルを作成するときに必要な初期化処理は、initializePanel() メソッドの中に記述します。（オーバーライド）
  • パネルが(再)構築されたときに呼び出されます。
• 出力データの作成に必要な（データの再生成時に必要な）初期化処理は、initializeData() メソッドの中に記述します。（オーバーライド）
  • 入力テキストの再読み込みがあった場合など、データ再生成の命令があったときに呼び出されます。
• 処理結果は、setData***() メソッドを利用して、可視化インタフェースツールに渡します。
  • ***の部分には渡すデータの型を表す文字列が入ります。
  • setData***() メソッドが呼び出された瞬間に、可視化インタフェースツール内の setData()メソッドが呼び出されます。
  • setData***() メソッドは、miningOperations() メソッドの中で、出力データを作成する処理が終わった後に記述します。

マイニング処理ツールの構成 †

初期化時の処理の流れ †

データ更新時（「再読込+実行」「再実行」「再処理を実行」）の処理の流れ †

データ送信の流れ †

サンプルプログラム †

Sample2.java ：入力テキストの単語間にスペースを入れた文字列を生成（ボタンを押すと実行）

作成の準備 †

• module/MiningModules フォルダ内に，自分が作成するツール（クラス）名のフォルダ(たとえばMyModule)を作成します．
  • モジュール名に使用できるのは，アルファベットか数字のみで，一文字目は大文字にする必要があります．
• 作成したフォルダ内に，ソースファイル MyModule.java を用意します．
• MiningModule クラスのサブクラスとして実装します．
• ボタンが押されたときの処理を追加するため ActionListener を追加します．

     例)  class MyModule extends MiningModule implements ActionListener

コンストラクタの作成 †

• setModuleIDメソッドにより，ツールIDを与えます．（公開用に取得したID，または他のツールとかぶらないID）

     例)  setModuleID(4723);

• 配列 pairingVisualizationID を初期化して，ペアとなる可視化インタフェースツールのIDを1つ以上指定します．

     例)  pairingVisualizationID = new int[]{1};

• ツールタイプが，1:シンプル，2:プリミティブ，3:セミプリミティブ，に該当するときは，setToolType(int) メソッドにより，該当するタイプ番号をセットして下さい．

     例)  setToolType(2);

• コンストラクタ内には，マイニングモジュールクラスのコンストラクタ用の処理以外は記述しないで下さい

変数の宣言 †

• クラス内のグローバル変数を宣言して下さい．
• 宣言した変数の初期化とインスタンス化は，必ずいずれかのメソッド内で行って下さい．

入力 †

• 入力は，マイニングモジュールクラスで定義されている TextData 型のインスタンス text を利用して下さい．

自動実行メソッドの実装 †

• マイニングモジュールクラスで用意されている下記のメソッドを，オーバーライドして実装してください．

[1.GUI初期化] void initializePanel(){} †

• Swing を利用して作成したGUIコンポーネントを，マイニングモジュールクラス内で定義されている JPanel 型のインスタンス operationPanel に add して下さい．

[2.初期化と前処理] void initializeData(){} †

• 処理ツール内の変数の初期化，マイニングの前処理を記述して下さい．
• GUIコンポーネントのうち，入力データに依存するものの初期化は，こちらに記述してください．

[5.マイニング処理と結果の出力] void miningOperations(int optionNumber){}　(実装必須） †

• 全体をswitch(optionNumber) case 文により記述した上で，case 0: の箇所に以下を記述してください．
  • マイニング処理の結果を生成する処理
  • 処理結果を可視化ツールに送る setData*** メソッド

出力 †

dataID について †

• 出力は，まず，dataID (可視化ツールがデータ受け取る際のID番号．可視化ツール内でデータ型ごとにカウント)の値を0にリセットする、下記のメソッドを呼び出してください。

   void resetData();

• setData*** メソッドにより可視化ツールがデータの受け取りに成功するごとに、可視化ツール内の，そのデータ型の dataID は 1 ずつ増加します
• dataIDの値は、ペアとする可視化ツールごとに、0から1ずつ増加していきます。

setData*** メソッド †

• 出力データの型に対応する setData*** メソッド（マイニングモジュールクラス内で定義）の引数に，生成したデータを与えて呼び出すことで、データを出力してください．

   void setDataBoolean(boolean data);
   void setDataInteger(int data);
   void setDataDouble(double data);
   void setDataString(String data);
   void setDataBooleanArray(boolean data[]);
   void setDataIntegerArray(int data[]);
   void setDataDoubleArray(double data[]);
   void setDataStringArray(String data[]);
   void setDataBooleanArray2(boolean data[][]);
   void setDataIntegerArray2(int data[][]);
   void setDataDoubleArray2(double data[][]);

• 上記のメソッドを1つだけ用いる場合，プリミティブツール（参考：ツールタイプ）となります．
• 特定の dataID のデータとして可視化ツールにデータを送りたい場合，上記メソッドの使用回数を把握して数を合わせるか，下記のメソッドにより直接 dataID を指定してデータを送ってください．

   void setDataBoolean(int dataID, boolean data);
   void setDataInteger(int dataID, int data);
   void setDataDouble(int dataID, double data);
   void setDataString(int dataID, String data);
   void setDataBooleanArray(int dataID, boolean data[]);
   void setDataIntegerArray(int dataID, int data[]);
   void setDataDoubleArray(int dataID, double data[]);
   void setDataStringArray(int dataID, String data[]);
   void setDataBooleanArray2(int dataID, boolean data[][]);
   void setDataIntegerArray2(int dataID, int data[][]);
   void setDataDoubleArray2(int dataID, double data[][]);

• dataID を指定するメソッドを利用した場合，データ型コンバートは行われません．（プリミティブ、セミプリミティブツール（参考：ツールタイプ）の認定対象外となります）
• マイニングモジュールクラスのsetFocusSegments, setFocusSentences, setFocusKeywordsメソッドによりフォーカス情報をセットした時に，同時にsetDataBooleanArrayのdataIDの4501番と4502番と4503番が用いられ，boolean型のfocusSegments[], focusSentences[], focusKeywords[]のfocus情報が自動的に送信されます．

GUI操作時の処理の実装 †

• GUIのアクションを制御するメソッド actionPerformed をオーバーライドして実装してください

     public void actionPerformed(ActionEvent e);

• GUIの操作時には，下記の処理を実行することが想定されます．
  • マイニング処理と結果の出力： miningOperations(optionNumber) メソッドを，特定の引数を与えて呼び出す．
    • 呼ばれた先の miningOperations メソッドでは，対応する optionNumber の case 文を増やして，マイニング処理の実行と，結果を出力する setData*** メソッドの呼び出しを行って下さい．
  • 可視化ツールの操作： 組み合わせて使用する可視化ツールの displayOperations(optionNumber) メソッドを，特定の引数を与えて呼び出す

コンパイル †

• 統合環境の tetdm フォルダ内で make または ant でコンパイルしてください．（自動的に統合環境に組み込まれます）
  • makeまたはantコマンドが無い場合は，コマンドをインストールしてください．
  • Windowsのコマンドプロンプトでは，Makefileに記述されているjavacコマンド内のワイルドカード*が使用できないことがあります．
    • その場合，antコマンドを使用できるようにしていただくか，cygwinなどのターミナルソフトのインストールが必要です．
  • antコマンドでコンパイルを行った場合，各フォルダ内にclassファイルは作成されませんが動作には問題ありません．

マイニング処理ツール作成用ツールキット †

• 処理ツール作成用ソース MiningToolKit.zip
• MiningToolKit.java
• MiningToolKit.txt
• Japanese.txt
• README.txt
  • ３つのボタンを用意し、ボタン名を日本語と英語で切り替え可能
    • 日本語と英語の切り替えは，「キーワード設定」最下部の「メニューを日本語にする」のチェックで行えます．
  • 各ボタンが押されると、テキストの一部をもとに作成したString型データを可視化ツールに送ります
  • プリミティブツール（ツールタイプ）