TrainPatMaxPattern
画像からパターンを抽出して登録し、検出するオブジェクトの登録済み (内部) 幾何学記述。FindPatMaxPatterns 関数で使用します。
TrainPatMaxPattern概要
PatMax® パターンは幾何図形特徴の集合です。ここで、各特徴は、ピクセル値が異なる 2 つの領域間の境界上の点です。TrainPatMaxPattern 関数でパターンを登録し、次に FindPatMaxPatterns 関数を使用して、画像内でそのパターンの 1 つ以上のインスタンスを検出します。PatMax は、マシンビジョンに利用可能なほかのパターン検出技術との差別化を図る、次の 3 つの重要な機能を提供します。
- 外観が、回転、スケーリング、伸長された対象物の高速検出
- 対象物のグレースケール値ではなく、形状に基づく検出技術
- 非常に高い精度
PatMax がほかのパターン検出技術と異なる点は、回転またはスケーリングを効率的かつ高精度に行うことができないピクセルグリッド表現に基づいてはいないということです。その代わりに、PatMax では、パターンマッチングのための迅速かつ正確な変換が可能な特徴ベースの表現を使用します。
TrainPatMaxPatternの入力パラメータ
Syntax:TrainPatMaxPattern(画像,フィクスチャ.行,フィクスチャ.列,フィクスチャ.角度,パターン領域.X,パターン領域.Y,パターン領域.高さ,パターン領域.幅,パターン領域.角度,パターン領域.カーブ,外部定義領域,パターン原点.行オフセット,パターン原点.列オフセット,パターン設定.アルゴリズム,パターン設定.融通性, パターン設定.極性を無視, パターン設定.感度, パターン設定.微粒度, パターン設定.粗粒度, 登録画像の再使用, タイムアウト,, 表示)
画像データ構造体を含んだスプレッドシートセルを参照するように指定します。デフォルトでは、このパラメータは、AcquireImage 画像データ構造体を含むセル A0 を参照しています。また、このパラメータは、ビジョンツールのグラフィックス関数や、座標補正関数により返された、そのほかの画像データ構造体も参照できます。 |
|||||||||||||||||||||||||
フィクスチャ入力、またはビジョンツール関数の画像座標系の出力に関連する対象領域 (ROI) を定義します。フィクスチャに関連する ROI を設定すると、フィクスチャが回転または移動した場合に、フィクスチャに対応して ROI を確実に回転または移動できます。 デフォルト設定は画像の左上隅で、(0, 0, 0) になります。
|
|||||||||||||||||||||||||
これは対象領域 (ROI) とも呼ばれ、解析の対象となる画像の領域を表します。変換および回転可能な矩形の画像領域を作成します。このパラメータを選択して、プロパティシートのツールバーにある [領域の最大化] ボタンを押すと、画像全体が対象になるように領域が自動的に拡張されます。
|
|||||||||||||||||||||||||
注 : [フィクスチャ] および [領域] パラメータは、画像の範囲内で定義されている必要があります。画像の範囲内で定義されていない場合、この関数は #ERR を返します。
|
|||||||||||||||||||||||||
このパラメータは、Annulus、Circle、Region、EditAnnulus、EditCircle、EditCompositeRegion、EditPolygon、または EditRegion の各関数を含むスプレッドシートセルを参照できます。このパラメータを使用すると、関数は [領域] と [フィクスチャ] の設定を無視し、参照先領域で指定された画像領域を検査します。EditCompositeRegion 関数コントロールを参照している場合は、検査領域がさまざまな形状の混合となることがあります。合成領域内の各形状は、検査領域に対して加算または減算 (マスキング) されるように割り当てることができます。 注 :
|
|||||||||||||||||||||||||
登録パターンの原点の行および列を、登録領域の中心からのオフセットとして指定します。
|
|||||||||||||||||||||||||
パターンの登録のための設定を指定します。
|
|||||||||||||||||||||||||
登録画像の再使用 |
パターンを登録するために使用した画像を保存し、[パターン設定] パラメータが変更されたときに使用するかどうかを指定します。
|
||||||||||||||||||||||||
関数が有効なパターンをサーチする時間をミリ秒単位で指定します (0 ~ 30000)。この時間が経過すると、処理は中止され、#ERR が返されます。値を 0 に設定すると設定値が無効になり、タイムアウトは適用されません。 |
|||||||||||||||||||||||||
画像上のグラフィックスの表示モードをTrainPatMaxPattern指定します。
|
TrainPatMaxPatternの出力
戻り値 | 登録されたパターンを含んでいるパターンデータ構造体。入力パラメータが無効であれば #ERR を返します。次の取り込みで新しいパターンを誤って登録することを避けるために、この関数はデフォルトで無効に設定されています。 |
結果 |
関数がTrainPatMaxPattern初めてセルに挿入されると、登録状態が右隣のセルに自動的に表示されます。パターンを登録できない場合は #ERR が挿入されます。 注 : この関数のプロパティシートには、パターンを登録し易くするためのヒントとして、補助的な情報文字列が表示されます。表示される可能性のある情報文字列については、ここをクリックしてください。
|
TrainPatMaxPatternデータアクセス関数
1 つのデータアクセス関数がスプレッドシートに自動挿入されます。
Trained | GetTrained(パターン) | パターンを登録できた場合には 1、登録できなかった場合には 0 を返します。 |