平行なエッジを計測

このツールでは、平行エッジ (オブジェクトの幅など) を計測します。

このツールには easyTouch および easyTouch+ を利用することができます。 したがって、画像では計測するエッジを対話的に選択でき、対応するパラメーターは自動的に適用されます。このツールは、指定されたパラメーターおよび、平行か否かにかかわらず、画像内のエッジに基づいて、平行なエッジを挿入します。計測する平行エッジの 1 本にマウスポインタを合わせます。MERLIC は、関心領域 (ROI) のプレビューと、そこに含まれる提案エッジペアを表示します。マウスポインタの位置で、対応する平行エッジの検索結果は異なり、マウスポインタがどちら側にあるかによって平行エッジは決まります。MERLIC はマウスがある側で平行エッジを検索します。したがって、マウスを一方の側からもう一方の側に移動すると、提案されたエッジのプレビューが変化します。easyTouch プレビューのエッジを計測するには、エッジペアをクリックして選択結果を確定します。このパラメーターは、選択したエッジに合わせて自動的に調整されます。ただし、対応するコネクターでは、手動でも調整できます。

さらに平行エッジを計測に追加するには、easyTouch+ を使用できます。つまり、Ctrl キーを押しながら追加のエッジペアを選択します。MERLIC は、選択したエッジペアが前の選択の現在のパラメーター設定に適合するかどうかを自動的に確認します。それらが適合しない場合、たとえばマウスが反対のエッジ遷移を持つエッジペアの上にあるといった場合、MERLIC はただちに、それぞれのエッジが easyTouch+ によって無視されるというフィードバックを出します。

あるいは、関心領域 (ROI) で計測することもできます。 現在のパラメーター設定を満たした適切なエッジペアが ROI にある場合、それらのエッジペアは自動的に決まり、計測が行われます。ROI は、開始点および終了点、つまりエッジの長さも決定します。曲線上のエッジを検出するには、小さな ROI を使用します。

ROI とエッジペアの色が異なることにご留意ください。ROI の色は、赤色と緑色の間で切り替わります。下表に示すように、色の違いによって、ROI 内のエッジが明瞭かどうかが示されます。

例	説明
	緑色にハイライトされた ROI は、明瞭なエッジペアを表します。
	赤色にハイライトされた ROI は、ROI 内に多くの平行なエッジがあるため、あいまいなエッジペアを表します。

提案された平行エッジの色は、下に示すように、青色と赤色の間で切り替わります。色の違いによって、提案されたエッジペアからのエッジ遷移が示されます。

例	説明
	プレビューで提案されたエッジは、以前にトレーニングしたエッジペアがないか、以前にトレーニングしたエッジペアのエッジ遷移が現在トレーニングしているエッジペアのエッジ遷移と一致する場合、青色にハイライトされます。
	easyTouch+ を使用する場合、赤色のエッジは、前にトレーニングしたものと反対方向のエッジ遷移であることを表します。

パラメーター

基本パラメーター

画像:

このパラメーターは、平行エッジを計測する入力画像を表します。

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

エッジコントラスト:

このパラメーターは、背景を基準にした平行エッジのコントラストを定義します。このパラメーターはグレイ値として定義され、デフォルト設定値は 10 です。 計測用に平行エッジペアを選択すると、このエッジペアの「エッジコントラスト」がただちに決まって、適用されます。easyTouch+ を使用してさらに平行エッジペアを追加した場合、選択対象に追加された各エッジペアについて「エッジコントラスト」が自動的に調整されます。しかし、対応するコネクターで値を手動で変更することもできます。

エッジ幅:

このパラメーターは、エッジの幅を定義します。このパラメーターはピクセル単位で定義され、デフォルト設定値は 2 ピクセルです。計測用にエッジペアが選択されると、そのエッジの「エッジ幅」が直ちに設定され、使用されます。easyTouch+ を使用してさらに平行エッジを追加した場合、選択対象に追加された各エッジペアについて「エッジ幅」が自動的に調整されます。しかし、対応するコネクターで値を手動で変更することもできます。

エッジ推移:

このパラメーターは、エッジペアの推移プロパティを設定します。推移は、内側から外側に決定されます。パラメーターの設定値はデフォルトで「任意」です。 測定用にエッジペアが選択されると、「エッジ推移」が直ちに設定され、選択対象に追加された各エッジペアについて自動的に調整されます。

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

値	説明
明から暗へ	エッジペアのエッジは、明から暗へ変化します。つまり、エッジは高いグレイ値から低いグレイ値に変化します。 この値が設定されている場合、この推移プロパティを持つエッジのみが計測されます。その他のエッジペアは計測から除外されます。
暗から明へ	エッジペアのエッジは、暗から明へ、すなわち、エッジは低い値から高いグレイ値に変化します。 この値が設定されている場合、この推移プロパティを持つエッジのみが計測されます。その他のエッジペアは計測から除外されます。
任意	エッジペアのエッジは、どちらの方向に変化してもかまいません。つまり、エッジは高いグレイ値から低いグレイ値、または低いグレイ値から高いグレイ値に変化します。 この値が設定されている場合、すべてのエッジペアが計測に含められます。

追加パラメーター

ROI:

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

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

アライメントデータ:

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

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

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

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

測定に失敗:

このパラメーターでは、計測を実行できない場合に「オブジェクト幅」の結果で返す値を指定します。パラメーターの設定値はデフォルトで「無視」です。 このパラメータは対応するコネクターで以下の値に設定できます。

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

結果

基本結果

平行エッジ:

この結果では、計測した平行エッジのグラフィック表示が返ります。結果は長方形 ROI として返り、ROI の方向矢印に垂直な ROI 境界が平行エッジを表します。

オブジェクト幅:

この結果では、計測した平行エッジ間の距離が返ります。結果はピクセル単位の実数で返ります。「キャリブレーションデータ」を使用すると、ワールド座標で距離が返ります。ひとつ以上の平行エッジペアを計測した場合、対応する幅がタプルで返ります。

ツール状態:

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

追加結果

処理時間:

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

アプリケーションの例

このツール、以下の MERLIC Vision App 例で使用します:

• measure_distance_to_center_led.mvapp