iemodel trainAndevaluate model

iemodel trainAndevaluate modelコマンドは、新しいモデルと既存モデルを評価およびトレーニングします。既存モデルの場合は、コマンドの引数 --u で "true" を指定することにより、新しくトレーニングされたモデルで既存モデルを上書きする必要があります。

このコマンドは、トレーニング オプション ファイルを使用し、評価結果ファイルを出力するように指定されている場合は、そのファイルを出力します。

使用方法

iemodel trainAndevaluate model--ftrainingOptionsFile--utrueOrFalse--ooutputFileName--ccategoryCount--dtrueOrfalse
必須 引数 説明
はい --f trainingOptionsFile モデルのトレーニングに使用するトレーニング オプション ファイルの名前と場所を指定します。ここでは、管理ユーティリティを実行しているディレクトリへの相対パスを使用します。
いいえ --u overWriteIfExists 既存のトレーニング済みモデルが存在する場合に、それを上書きするかどうかを指定します。
true
既存のモデルを上書きします。
false
既存のモデルを上書きしません。
いいえ --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) だったエンティティ発生数。

例

この例の内容は次のとおりです。
  • "C:\Spectrum\IEModels" にある "ModelTrainingFile" というトレーニング オプション ファイルを使用
  • 同じ名前の既存の出力ファイルがあれば上書き
  • "MyModelTestOutput" というファイルに評価の出力を格納
  • カテゴリ数は 4
  • 評価の詳細分析は必須
iemodel trainAndevaluate model --f C:\Spectrum\IEModels\ModelTrainingFile --u true --o C:\Spectrum\IEModels\MyModelTestOutput --c 4 --d true