外れ値を計測

このツールでは、エッジから近似線分までの距離 (エッジの外れ値など) を計測します。

このツールには easyTouch を利用できます。 したがって、画像では計測するエッジを対話的に選択でき、対応するパラメーターは自動的に適用されます。計測するエッジにマウスカーソルを合わせます。MERLIC には、提案されたエッジのプレビューが表示されます。プレビューしたエッジを計測するには、エッジをクリックして選択結果を確定します。このパラメーターは、選択したエッジに合わせて自動的に調整されます。さらに、ライン線分は、選択したエッジに近似されます。このライン線分は、距離基準として使用します。すなわち、外れ値は、基準線分とエッジ間の距離を計測して決定します。対応するコネクターでパラメーター値を手動変更すれば、さらに調整ができます。

あるいは、関心領域 (ROI) で計測することもできます。画像に ROI を描画します。現在のパラメーター設定を満たす可能性のあるエッジが ROI にある場合、そのエッジは自動的に決まり、計測が行われます。

パラメーター

基本パラメーター

画像:

このパラメーターは、外れ値を計測する入力画像を表します。

色画像をこのツールの入力として使用すると、最初のチャンネル (赤いチャンネル) のみが処理の対象になります。

エッジコントラスト:

このパラメーターは、背景を基準にしたエッジのコントラストを定義します。このパラメーターはグレイ値として定義され、デフォルト設定値は 10 です。 計測用にエッジが選択されると、このエッジの「エッジコントラスト」が直ちに設定され、使用されます。しかし、対応するコネクターで値を手動で変更することもできます。

エッジ幅:

このパラメーターは計測するエッジ線分の幅を定義します。このパラメーターはピクセル単位で定義され、デフォルト設定値は 2 ピクセルです。計測用にエッジが選択されると、このエッジの「エッジ幅」が直ちに設定され、使用されます。しかし、対応するコネクターで値を手動で変更することもできます。

エッジ推移:

このパラメーターは計測するエッジ線分の推移プロパティを定義します。推移は、外側から内側に決まります。パラメーターの設定値はデフォルトで「明から暗へ」です。 エッジ間隔内で計測用に基準オブジェクトのエッジペアを選択すると、「エッジ推移」は直ちに確定します。

「エッジ推移」は、エッジ線分のどちらにマウスポインタがあるかで決まります。グレイ値の高い側にマウスを合わせると、「エッジ推移」の判定は「明から暗へ」になり、それ以外は「暗から明へ」になります。したがって、マウスポインタの位置も、easyTouch による値の決定方法に反映されます。

値	説明
明から暗へ	エッジ線分は明から暗へ、すなわち、エッジのグレイ値が高い値から低い値に変化します。 この値が設定されている場合、この推移プロパティを持つエッジのみが計測されます。その他のエッジペアは計測から除外されます。
暗から明へ	エッジ線分は、暗から明へ、すなわち、エッジのグレイ値が低い値から高い値に変化します。 この値が設定されている場合、この推移プロパティを持つエッジのみが計測されます。その他のエッジペアは計測から除外されます。

追加パラメーター

ROI:

このパラメーターは、処理用の関心領域 (ROI) を定義します。 デフォルトで、「ROI」は空に定義されます。ROI を処理に使用する場合は、前のツールの適切な ROI 結果にパラメーターを接続するか、使用可能な ROI ボタンで新しい ROI を画像に描画します。

現在のパラメーター設定を満たすエッジがないか ROI のチェックが行われます。たとえば、「エッジ推移」を「暗から明へ」に設定すると、このツールは暗から明に変化するエッジがないか ROI 方向に検索を行います。適切なエッジが見つかると、それらは計測に使用されます。

アライメントデータ:

このパラメータは、ROI のアライメントに使用するアライメントデータを表します。デフォルトでは、アライメントデータが接続されていないため、効果はありません。特定のアライメントデータを使用するには、マッチングによるアライメント、直線境界でアライメントを決定、画像をアライメント、あるいは 画像を回転 など、パラメータを適切な前のツールの結果に接続します。

キャリブレーションデータ:

このパラメータでは、レンズの歪みの補正と画像平面を基準にしたカメラの位置の補正に必要なキャリブレーションデータを定義します。デフォルトで、キャリブレーションデータは定義されません。キャリブレーションデータを使用するには、キャリブレーションデータがこのツールに送信されるよう、このパラメータを カメラキャリブレーション など、前のツールの適切な結果に接続します。結果は直ちに画像に適用されます。

このツールで「キャリブレーションデータ」を使用する場合、ピクセル値を表すすべての結果は、対応するワールド座標に自動的に変換されます。

距離の参照:

このパラメーターは計測の距離基準を定義します。このパラメーターで、選択したエッジまでの距離を近似線分または ROI の 1 本の境界線分から計測するかどうかを決定します。このパラメータのデフォルト設定値は「フィッティングした線分」です。「距離の参照」を変更する場合、対応するコネクターの利用可能なオプションを使用して目的の参照ラインを選択します。以下の表は、「距離の参照」に使用できる値の解説と、それぞれの値でどの線分を使用するかを示したサンプル画像です。

値	説明	画像例
フィッティングした線分	距離基準は、選択したエッジに近似した線分です。右側の画像例で、距離基準として使用される近似した線分はわかりやすいようオレンジ色のラインで表示されます。選択したエッジは、ROI で緑色に表示されます。 抽出されたエッジまでの距離は、近似した線分に垂直に計測します。距離は代数符号付きで返ります。 近似線分を下回るエッジ点には負号が付き、線分を上回るエッジ点は正号が付きます。
ROI	距離基準は、計測用にエッジを選択したときに自動的に挿入される長方形 ROI の境界線分です。 右側の画像例で、距離基準として使用される適合した ROI 境界線分はオレンジ色のラインで表示され、結果の「フィッティングした線分」は緑色に表示されます。 エッジまでの距離は、ROI 境界線分から、ROI 方向に沿って計測します。

測定に失敗:

このパラメーターでは、計測を実行できない場合に、「下側アウトライアー距離」、「上側アウトライアー距離」、「エッジ完全性」、「真直度」および「平均距離」の結果で返す値を指定します。パラメーターの設定値はデフォルトで「無視」です。このパラメータは対応するコネクターで以下の値に設定できます。

値	説明
無視	計測を実行できない場合、値を返しません。
-1	計測を実行できない場合、-1 を返します。 この値は、返す任意の数字や文字列を、コネクターの入力フィールドに直接置き換えることができます。
*	計測を実行できない場合、* を返します。 この値は、返す任意の数字や文字列を、コネクターの入力フィールドに直接置き換えることができます。

結果

基本結果

エッジ:

この結果では、外れ値を計測した選択エッジの輪郭が返ります。

下側アウトライアー:

この結果では、選択したエッジ上で、下側アウトライアーを示す点が返ります。「距離の参照」を「フィッティングした線分」に設定すると、ROI の負の方向で最も離れた位置にあるアウトライアーが返ります。「距離の参照」を ROI に設定すると、ROI の基準側に最も近いアウトライアーが返ります。「下側アウトライアー」と「距離の参照」の間の距離は、「距離の参照」に垂直に計測されます。結果は点 ROI として返ります。 パラメーター「距離の参照」の解説の画像例のように、画像では十字として表示されます。

上側アウトライアー:

この結果では、選択したエッジ上で、上側アウトライアーを示す点が返ります。「距離の参照」を「フィッティングした線分」に設定すると、ROI の正の方向で最も離れた位置にあるアウトライアーが返ります。「距離の参照」を「ROI」に設定すると、ROI の基準側に最も遠いアウトライアーが返ります。「上側アウトライアー」と「距離の参照」の間の距離は、「距離の参照」に垂直に計測されます。結果は点 ROI として返ります。 パラメーター「距離の参照」の解説の画像例のように、画像では十字として表示されます。

下側アウトライアー距離:

この結果では、「下側アウトライアー」と定義済みの「距離の参照」の間の負号付き距離が返ります。符合付きの実数としての 結果はピクセル単位で返ります。。「キャリブレーションデータ」を使用すると、ワールド座標で距離が返ります。

上側アウトライアー距離:

この結果では、「上側アウトライアー」と定義済みの「距離の参照」の間の負号付き距離が返ります。符合付きの実数としての 結果はピクセル単位で返ります。。「キャリブレーションデータ」を使用すると、ワールド座標で距離が返ります。

ツール状態:

「ツール状態」はツール状態の情報を返します。したがって、エラー処理に使うことができます。さまざまなツールの状態結果の詳細については、 ツール状態 結果 のトピックを参照してください。

追加結果

フィッティングした線分:

この結果では、選択したエッジに近似した線分のグラフィック表示が返ります。結果は線分 ROI として返ります

平均距離:

この結果では、選択したエッジと定義済みの「距離の参照」の間の絶対距離の平均値が返ります。値は必ず正値です。結果はピクセル単位の実数で返ります。「キャリブレーションデータ」を使用すると、ワールド座標で距離が返ります。

エッジ完全性:

この結果では、外れ値が計測されたエッジの「エッジ完全性」が返ります。この値は、実数 0 から 1 の範囲で定義され、エッジの輪郭がどの程度乱れるかを示す指標になります。値が大きいほどエッジの乱れが少なくなり、エッジ完全性が高くなります。

処理時間:

この結果は、ツールの直近の実行の持続時間をミリ秒単位で返します。結果は、追加結果として提供されます。したがって、デフォルトでは非表示になっていますが、ツール結果の横にある ボタンを使用して表示できます。詳細については、ツールリファレンス概要の処理時間の節を参照してください。