パターン

注 :  次の関数はそれぞれ、最初のパラメータとして、パターンデータ構造体を参照します。インデックス (ゼロから始まる) は、構造体からインデックスされているパターンを決定します。
関数 説明

GetAngle(パターン, [インデックス])

角度の値を返します。この関数は、FindPatMaxRedLineColor、FindPatMaxRedLine、FindPatMaxPatterns、FindPatterns、SortPatterns の各関数と連携します。

GetClutter(パターン, [インデックス])

クラッタのスコアを返します。この関数は、FindPatMaxRedLineColor、FindPatMaxRedLine、FindPatMaxPatterns の各関数と連携します。

GetCol(パターン, [インデックス])

列の値を返します。この関数は、FindPatMaxRedLineColor、FindPatMaxRedLine、FindPatMaxPatterns、FindPatterns、SortPatterns の各関数と連携します。

GetColorScore(パターン, [インデックス])

カラー得点の値 (0 ～ 100) を返します。この関数は、FindPatMaxRedLineColor のみと連携します。

注 :  

参照先 TrainPatMaxRedLineColor の [カラーマッチ] パラメータが [マッチなし] に設定されている場合、GetColorScore 関数は 100.000 を返します。

[カラーマッチ] パラメータの選択項目 動作
0 = すべてのカラー (デフォルト) ツールによって一致する特徴が検出されたことを前提に、計算されたスコアを返します。
1 = 選択カラー
2 = マッチなし 100.000 を返します (ツールによって、カラーマッチスコアは計算されません)。

GetContrast(パターン, [インデックス])

コントラストの値を返します。この関数は、FindPatMaxRedLineColor、FindPatMaxRedLine、FindPatMaxPatterns の各関数と連携します。

  • FindPatMaxRedLineColor と FindPatMaxRedLine のコントラスト値は、登録パターン内の特徴とサーチ画像内の一致する特徴との間のコントラスト差をパーセンテージで表した、「相対」コントラストが報告されます。よって、特徴のコントラストがパターンコントラストと同じまたはより高い場合、報告されるコントラストは ～100 となります。パターンコントラストが特徴のコントラストを超えた場合、報告されるコントラストは <100 となります。
  • FindPatMaxPatterns コントラストは、グレースケール階調で表した、サーチ ROI 内の絶対画像コントラストです。

GetCoverage(パターン, [インデックス])

カバレッジのパーセンテージを返します。この関数は、FindPatMaxRedLineColor、FindPatMaxRedLine、FindPatMaxPatterns の各関数と連携します。

GetErrorCode(パターン, [インデックス])

パターンに対するエラーコードを返します。この関数は Pattern Match 関数 (TrainPatMaxRedLineColor、FindPatMaxRedLineColor、TrainPatMaxRedLine、FindPatMaxRedLine、TrainPatMaxPattern、FindPatMaxPatterns、FindPatterns、および SortPatterns) と連携します。

閉じたエラーコードとそれに対応する情報文字列

エラーコード 対応する情報文字列
00000008 操作のタイムアウト時間を超過しました。

PatMax

エラーコード 対応する情報文字列
07010000 パターンに含まれるマッチ特徴が少なすぎることがあります。
07010001 特徴の粒度を自動的に設定するのは困難です。
07010100 手動で [粒度] を設定してください。登録画像の表示がぼやけているので、パターンが予想より正確でないことがあります。
07010102 疎粒度の特徴が同じ方向であるために、パターン結果が不安定になることがあります。
07010200 高精度な特徴が多いため、実行時間が長くなることがあります。手動で [粒度] を設定してください。
07010101 パターンに含まれる情報が不十分なため、角度またはスケールを正確に測定できないことがあります。
07020300 コントラストが低いため、結果は破棄されました。
07020301 より正確な結果を得るため、結果は破棄されました。
07020302 クラッタが多すぎるため、結果は破棄されました。
07020303 現在のパラメータ設定に対して、登録パターンに含まれる特徴が少なすぎます。
07030000 エラー情報はありません。

PatMax RedLine (グレースケールとカラー)

エラーコード 対応する情報文字列
07020306 グレースケールの入力画像はサポートされていません。
07020307 マッチカラーが登録されていません。
07010100 参照しているカラーマッチマスク画像のサイズが、入力領域と一致しません。
07020308 入力画像を登録できません。
07020309 高精度な特徴が多いため、実行時間が長くなることがあります。手動で [粒度] を設定してください。
07020310 カラーパターンを登録できません。

GetFitError(パターン, [インデックス])

一致誤差の得点を返します。この関数は、FindPatMaxPatterns 関数のみと連携します。

GetGranCoarse(パターン)

粗粒度値を返します。この関数は、TrainPatMaxRedLineColor、TrainPatMaxRedLine、TrainPatMaxPattern と連携します。

GetGranFine(パターン)

微粒度値を返します。この関数は、TrainPatMaxRedLineColor、TrainPatMaxRedLine、TrainPatMaxPattern と連携します。

GetInfoCode(パターン, [インデックス])

情報文字列に対する診断コードを返します。この関数は、TrainPatMaxPattern 関数および FindPatMaxPatterns 関数と連携します。

閉じた診断コードとそれに対応する情報文字列

注 :  このツールは GetInfoString 関数を使って情報文字列をスプレッドシートに挿入します。

TrainPatMaxPattern 関数

診断コード 対応する情報文字列
07010000 パターンに含まれるマッチ特徴が少なすぎることがあります。
07010001 特徴の粒度を自動的に設定するのは困難です。
07010100 手動で [粒度] を設定してください。登録画像の表示がぼやけているので、パターンが予想より正確でないことがあります。
07010102 疎粒度の特徴が同じ方向であるために、パターン結果が不安定になることがあります。
07010200 高精度な特徴が多いため、実行時間が長くなることがあります。手動で [粒度] を設定してください。
07010101 パターンに含まれる情報が不十分なため、角度またはスケールを正確に測定できないことがあります。
07030000 エラー情報はありません。

FindPatMaxPatterns 関数

診断コード 対応する情報文字列
07020300 [値] 低コントラストのために破棄された結果。
07020301 [値] より正確な結果を得るために破棄された結果。
07020302 [値] クラッタが多すぎるために破棄された結果。
07020303 現在のパラメータ設定に対して、登録パターンに含まれる特徴が少なすぎます。

GetInfoString(パターン, [インデックス])

情報文字列を返します。この関数は、TrainPatMaxPattern 関数および FindPatMaxPatterns 関数と連携します。

GetNFound(パターン)

検出されたパターン一致の数を返します。この関数は、FindPatMaxRedLineColor、FindPatMaxRedLine、FindPatMaxPatterns、FindPatterns、SortPatterns の各関数と連携します。

GetOutsideArea(パターン, [インデックス])

サーチ領域外で検出された一致パターンの領域の割合 (0 から 1 の段階で、0 はすべて内部、1 はすべて外部での検出) を返します。この関数は、FindPatMaxPatterns 関数のみと連携します。

GetOutsideFeatures(パターン, [インデックス])

サーチ領域外で検出された一致パターンの特徴の割合 (0 から 1 の段階で、0 はすべて内部、1 はすべて外部での検出) を返します。この関数は、FindPatMaxPatterns 関数のみと連携します。

GetRow(パターン, [インデックス])

行の値を返します。この関数は、FindPatMaxRedLineColor、FindPatMaxRedLine、FindPatMaxPatterns、FindPatterns、SortPatterns の各関数と連携します。

GetScale(パターン, [インデックス])

登録パターンと比較した一致のサイズ (%) を返します。この関数は、FindPatMaxRedLineColor、FindPatMaxRedLine、FindPatMaxPatterns、FindPatterns、SortPatterns の各関数と連携します。

GetScaleX(パターン, [インデックス])

登録パターンと比較した X 方向の一致のサイズ (%) を返します。この関数は、FindPatMaxPatterns 関数のみと連携します。

GetScaleY(パターン, [インデックス])

登録パターンと比較した Y 方向の一致のサイズ (%) を返します。この関数は、FindPatMaxPatterns 関数のみと連携します。

GetScore(パターン, [インデックス])

パターンのレスポンス得点の値を返します。この関数は、FindPatMaxRedLineColor、FindPatMaxRedLine、FindPatMaxPatterns、FindPatterns、SortPatterns の各関数と連携します。

GetTrained(パターン)

ツールが適切にパターンを学習した場合は 1 を返します。ツールが パターン構造体からパターンを登録できない場合は、0 を返します。この関数は、  TrainPatMaxPattern、TrainPatMaxRedLine、TrainPatMaxRedLineColor、および FindPatterns と連携します。