iemodel evaluate model

iemodel evaluate コマンドは、Information Extraction モジュールのトレーニング済みモデルを評価します。

使用方法

iemodel evaluate model--nmodelName--ttestFileName--ooutputFileName--ccategoryCount--dtrueOrfalse
必須引数説明
はい--n modelName評価するモデルの名前と場所を指定します。ここでは、管理ユーティリティを実行しているディレクトリへの相対パスを使用します。
はい--t testFileNameモデルの評価に使用するテスト ファイルの名前と場所を指定します。
いいえ--o outputFileName評価結果を格納する出力ファイルの名前と場所を指定します。
いいえ--c categoryCountモデル内のカテゴリ数を指定します。数値を指定する必要があります。
注: テキスト分類モデルのみに適用されます。
いいえ--d trueOrfalseテーブルをエンティティに関する詳細分析とともに表示するかどうか指定します。値は次の true または false にする必要があります。
true
詳細な評価結果が必要。
false
詳細な評価結果は必要ない。
デフォルトは false です。

モデル評価の結果テーブルと、その列を示す混同行列には、以下に示すように、各エンティティの数が表示されます。

注: この引数を指定しないか、この引数の値を false に指定してコマンドを実行すると、モデル評価の結果テーブルと混同行列は表示されません。モデル評価の統計値のみが表示されます。

出力

モデル評価の統計値
このコマンドを実行すると、テーブル形式で以下の評価の統計情報が表示されます。
  • 適合率: 厳密性を示す指標です。適合率は、正しく識別された組の割合を示します。
  • 再現率: 結果の完全性を示す指標です。再現率は、関連するインスタンスのうち、検出されたインスタンスの比率として定義できます。
  • F1 値: テストの正確性を示す指標です。F1 スコアの計算では、テストの適合率と再現率の両方が考慮されます。これは適合率と再現率の加重平均として解釈でき、F1 スコアの最高値は 1、最低値は 0 になります。
  • 正確度: 結果の正確性を示す指標です。これは測定値と既知値の近さを示します。
モデル評価の結果
コマンドを引数 --d true を指定して実行すると、すべてのエンティティのマッチ数がテーブル形式で表示されます。そのテーブルには次の列があります。
Input Count (入力数)
入力データ内のエンティティの発生数。
Mismatch Count (不一致数)
エンティティのマッチが失敗した回数。
Match Count (マッチ数)
エンティティのマッチに成功した回数。
混同行列
混同行列 (以下を参照) では、アルゴリズムの性能を視覚化できます。分類モデルの性能を示します。
列は予測クラスのインスタンスを表し、行は実際クラスのインスタンスを表します。混同行列に関連する語として、次のようなものがあります。
実際
実際クラス内のエンティティの発生数。
予測
予測クラス内のエンティティの発生数。
TP
真陽性 (True Positive): 陽性 (positive) と予測され、実際にも真 (true) だったエンティティ発生数。
TN
真陰性 (True Negative): 陰性 (negative) と予測されたが、実際には真 (true) だったエンティティ発生数。
FP
偽陽性 (False Positive): 陽性 (positive) と予測されたが、実際には偽 (false) だったエンティティ発生数。
FN
偽陰性 (False Negative): 陰性 (negative) と予測され、実際にも偽 (false) だったエンティティ発生数。

例

この例の内容は次のとおりです。
  • "MyModel" というモデルを評価
  • 同じ場所にある "ModelTestFile" というテスト ファイルを使用
  • "MyModelTestOutput" というファイルに評価の出力を格納
  • カテゴリ数は 4
  • 評価の詳細分析は必須
iemodel evaluate model --n MyModel --t C:\Spectrum\IEModels\ModelTestFile --o C:\Spectrum\IEModels\MyModelTestOutput --c 4 --d true