VisualApplets
オペレーターリファレンス

BlobDetector2D は、BoundingBox、Area、および Center of Gravity X と Y の機能をサポートしています。

入力画像は、オペレーターによって行単位で処理されます。オペレーターは未来を予測できないため、後で接続される領域は最初は独立しているように見える場合があります。したがって、このテキストでは、1つの行内の接続されたピクセルは object artifacts と呼ばれます。BlobDetector2D オペレーターは、それらの object artifacts が後続の行の他の object artifacts と重なっているかどうかを確認します。これは、オブジェクトが本当に独立しているのか、それともより大きなオブジェクトの一部であるのかを判断するためです。オペレーターが処理できる object artifacts の最大数は、LabelCount パラメータによって定義されます。object artifacts の数が LabelCount の値を超えると、データが失われ、オブジェクト結果の整合性が保たれなくなります。これは context corruption と呼ばれます。データが失われた行には、ErrorFlag で判別できる Line Error ダミーオブジェクトがマークされます。破損したコンテキスト内の後続のすべてのオブジェクトには、そのようにフラグが立てられます。コンテキストの破損は、フレームの終了時またはアプレットの再起動によってコンテキストが自動的にリセットされると終了します。すべてのエラーフラグは、'Output Ports' セクションにリストされています。

ほとんどの場合、コンテキストの破損を防ぐために必要なラベルの数は、1つのライン内のobject artifactの最大数に等しくなります。neighborhood = 4およびneighborhood = 8の場合、必要な正確な数は若干異なります：

選択したラベルの量がユースケースに対して十分であるかどうかわからない場合は、シミュレーションで確認してください。

BlobDetector2D モジュールをインスタンス化する際、作成する出力ポートを定義できます。ポートを有効または無効にすると、対応する機能も自動的に有効または無効になります。これらのポートを確認した後は、変更できなくなります。他の出力ポートが必要な場合は、別の BlobDetector2D モジュールをインスタンス化する必要があります。

ブロブ検出器オペレーターは、処理速度（つまり帯域幅）が画像コンテンツに依存する数少ないオペレーターの1つです。このオペレーターは、連続するライン内で前景ピクセルと背景ピクセルの変化が少ない画像に対して最も効果的に動作します。したがって、ノイズが多い場合や、複数のライン内でobject artifactの数が多い場合、データスループットが著しく低下します。ただし、これは非常に強いノイズを含む画像にのみ適用されます。

オペレーターは、入力画像を行単位で処理することで、最小限のレイテンシで動作します。オブジェクトの終了が明確になると、オブジェクトの機能がオペレーターによって即座に出力として提供されます。したがって、オブジェクトの出力は、それが終了するのと同じ行で行われます。これにより、画像自体がオペレーターによって処理されている間でも、完了したオブジェクト機能の後処理が可能になります。

DMA およびその他のいくつかのオペレーターは、完了を報告する前にフレーム終了信号を待機することに注意してください。フレーム終了信号は、入力画像の最後の行が処理されると生成されます。

オペレーターのリソース消費量は、有効な機能、機能に使用されるビット数、および選択されたラベルの数に依存します。したがって、Baslerでは、不要な機能を無効にすること、およびLabelCountパラメータを設定する際には慎重に行うことを推奨しています。

ブロブ検出器の ImageI 入力には、バイナリ（ピクセル Bit Width 1）、2D 画像が必要です。オペレーターは、画像内の異なる行長の入力や、空の行および空のフレームをサポートしています。

オペレーターは、前景値が ONE であり、背景値が ZERO であると仮定します。事前の二値化処理でこの要件を満たしていることを確認してください。

出力は、VALT_IMAGE2D 画像形式の形式で表されます。出力ポートのそれぞれは、1つのオブジェクト機能 / オブジェクトプロパティを表します。それらは同期しており、合わせて1つの単一のオブジェクトを記述します。各出力ピクセルは、完了したオブジェクトまたはステータスエラーオブジェクトのいずれかの値を提供します。この出力が抽出されたオブジェクトであるかステータスエラーオブジェクトであるかは、ErrorFlagsO 出力ポートによって示されます。オブジェクトを表すピクセルは、オブジェクトが完了したのと同じ行に表示されます。それらは完了の順序に出力されます。たとえば、2つのオブジェクトが10行目で終了します。オブジェクト A の最後のピクセルは X 座標 42 を持ち、オブジェクト B の最後のピクセルは X 座標 97 を持ちます。したがって、オブジェクト A は最初のエントリであり、オブジェクト B はオペレーターの出力ポートにおける 2 番目のピクセルです。オブジェクトが完了せず、エラーが発生しなかった行は空です。

Propertyデータのオーバーフローを防ぐため、出力ポートの幅は、指定された入力形式に基づいて自動的に適応します。または、出力ポートの幅を手動で設定することもできます。リンクのBit Widthの手動設定は、オペレーターのPropertyで有効にしている場合、Area／CenterX／CenterYで使用できます。

ポート ErrorFlagsO は、オーバーフローや追加の情報タグに関するいくつかのエラーフラグを出力します。各ビットは特定のエラーフラグ用に予約されています。これらのエラーフラグは、ハードウェアの実行環境またはシミュレーションで確認できます。シミュレーションでこれらのエラーフラグを確認するには：

エラーフラグの詳細な説明は、以下のパラメータ説明に記載されています。概要は次の表に示されています：

BlobDetector2Dオペレーターの使用方法は、以下の例に示されています：