<?xml version='1.0' encoding='Shift_JIS' ?>
<doc xml:lang='ja'>
	<body>
		<p>評価フェーズでは、これまで実装してきたモデルをBESP上で実行し、 その評価を行います。
			ここでは、プログラムのための開発ツールがeclipseとして解説します。</p>
		<subsection title="モデルを実行する">
			<subsubsection title="BESPのプラグインとしてモデルを.jarファイルに変換する">
				<p>モデルをBESPのプラグインとして実行するためには、作成したモデルをjar形式で圧縮し、
					BESPをインストールしたディレクトリにあるpluginsというディレクトリに配置する必要があります。 『Boxed
					Economy Simulation Platform ユーザーズマニュアル』”5.1. プラグインの追加”
					を参照してください。</p>
				<p>モデルをjar形式で圧縮するにはeclipse上で以下のような操作をする必要があります。</p>
				<ol>
					<li>実行したいモデルを含むソースフォルダをパッケージエクスプローラで選択します。</li>
					<li>右クリックからExportを選択します。</li>
					<li>ファイルをエクスポートする形式を聞かれるのでJarファイルを選択して "next"をクリックします</li>
					<li>
						エクスポート先のディレクトリ名と、エクスポートするファイル名を入力します。このとき、エクスポート先をBESPをインストールしたディレクトリの、
						pluginsに設定すると、エクスポートしたモデルをBESP上で実行することができます。
						.jarファイルを作ることによって、他の人も同じようにシミュレーションを実行することができます。</li>
				</ol>
			</subsubsection>
			<subsubsection title="eclipse上でBESPを実行する">
				<p>現在開発中のモデルをBESP上で実行するためには以下のような操作をする必要があります。
					この方法でBESPを実行するためにはbesp.jarへのクラスパスが通っている必要があります。</p>
				<p>まずWorldに以下のようなメインメソッドを実装します。</p>
				<program title="メインメソッドの実装(MarketforLemonWorld.java)"
					javasrcKeyword="main"
					src="src/model/MarketForLemonWorld.java"
					normalizer="javasrc" javasrcSyntaxHilight="true"
					encoding="Shift_JIS" />
				<p>実行したいWorldをパッケージエクスプローラで選択します。</p>
				<figure id="fig:eval_selectworld" src="image/eval_select_world"
					title="Worldの選択"/>
				<p>RunメニューからRun As>Java Applicationを選択します。</p>
				<figure id="fig:eval_run_menu" src="image/eval_run_menu"
					title="Run As"/>
				<p>
					eclipse上でBESPを実行すると、通常どおり単独のアプリケーションとしてBESPを起動する場合とでは以下のような違いがあります。</p>
				<table style="width:100%" title="実行時に読み込まれるモデル">
					<thead>　,通常の実行ファイルから起動した場合,eclipse上で実行した場合</thead>
					<tbody>
						<tr>
							<td>読み込まれるモデル</td>
							<td>pluginsに含まれているモデル</td>
							<td>実行したプロジェクトから参照することのできるモデル</td>
						</tr>
						<tr>
							<td>デバッグモード</td>
							<td>使用できません</td>
							<td>使用できます</td>
						</tr>
					</tbody>
				</table>
			</subsubsection>
			<subsubsection title="eclipse上で引数を与えてBESPを実行する">
				<p>ただRun Asを使って、BESPを実行しただけでは、eclipseのコンソールには何も表示されません。
					しかし、モデルの評価をする際には、モデルの情報をコンソールに表示させる必要がであります。</p>
				<p>コンソールに情報を表示させるには-printというオプションをBESPに与えて起動する必要があります。
					このようにオプションを使うとBESPが持つ便利な機能を利用する事ができます。
					オプションの詳細については『Boxed　Economy Simulation Platform
					ユーザーズマニュアル』”5.2. 起動時の引数” を参照してください。</p>
				<p>BESPを引数を与えてeclipse上で実行するには、まずRunメニューから"Run"を選択します。
					実行設定のダイアログが出るので"Arguments"タブを選択します</p>
				<figure id="fig:eval_run_dialog" src="image/eval_run_args"
					title="引数の設定"/>
				<p>"Program Arguments"という入力フィールドにBESPに渡す引数を入力します。
					例ではprintオプションとmodelオプションを渡しています。</p>
			</subsubsection>
		</subsection>
		<subsection title="ログを読む"> <p>実行時にモデルがどのように値が変化しているのかを知るためにログを出すことができます。
			BESPは、何も設定されていなければファイルに書き出すように設定されています。
			これを変更するには起動オプションの-logconfを使います。 デフォルトで設定できるログの書き出し方は以下の三種類です。
			この3種類以外の設定を使用するときは設定ファイルを作成して-logconfオプションで指定してください。</p> 
				<table style="width:100%" title="ログのオプション"> 
			<thead>オプション,ログの書き出され方</thead> <tbody> <tr> <td>-logconf jar.console</td>
			<td>コンソールにログを書き出します</td> </tr> <tr> <td>-logconf jar.file</td> <td>
			ファイル(error.log)にログを書き出します</td> </tr> <tr> <td>-logconf jar.gui</td> 
			<td>GUIのログ表示画面を使ってログを表示します。</td> </tr> </tbody> </table> <p>
			GUIのログ表示画面を使用する設定にするとBESPのLogというメニューが使えるようになります。</p> <figure
			id="fig:eval_log_menu" src="image/eval_log_menu" title="Logメニュー"/> 
			<p>世界を読み込んだ後、これを選択すると以下のような画面が現れます。</p> <figure
			id="fig:eval_log_window" src="image/eval_log_window"
			title="Logウィンドウ"/> 画面左側にあるツリーがログを吐き出しているクラスのパッケージ構造をあらわしています。
			モデルの評価を行う際にもっとも重要となるBehaviorの状態遷移に関するログはbehaviorパッケージを選択すると
			画面に表示されます。</subsection>
		<subsection title="モデルを評価する">
			<p>今後モデルを使ってシミュレーションを行う際に信頼できる結果を得るためには、モデルの正当性を検証する必要があります。
				そのために実行結果やログを利用してモデルの評価を行います。</p>
		</subsection>
	</body>
</doc>
