エッジの間隔を計測
このツールでは、オブジェクトの距離と、行間隔 (平行エッジペアの距離) を計測します。
このツールには easyTouch を利用できます。 したがって、画像では計測する行間隔内のエッジを対話的に選択でき、対応するパラメーターは自動的に適用されます。計測する行間隔内のエッジにマウスカーソルを合わせます。MERLIC には、提案された行間隔の平行エッジのプレビューが表示されます。マウスポインタの位置で、対応するエッジペアの検索結果は異なります。すなわち、マウスポインタがどちら側にあるかによって対応するエッジは決まります。MERLIC は、マウスがある側を、計測するオブジェクトの一部として解釈し、反対側をギャップの一部として解釈します。したがって、マウスを一方の側からもう一方の側に移動すると、提案されたエッジのプレビューが変化します。プレビューした行間隔を計測するには、エッジをクリックして選択結果を確定します。エッジは、エッジペアの形で処理されます。このパラメーターは、選択したエッジに合わせて自動的に調整されます。ただし、対応するコネクターでは、手動でも調整できます。
あるいは、関心領域 (ROI) で計測することもできます。画像に ROI を描画します。現在のパラメーター設定を満たした適切な行間隔のエッジが ROI にある場合、それらのエッジは自動的に決まり、計測が行われます。このツールがサポートしているのは、単独 ROI の使用のみです。以前のツールの接続から引き継ぐか、ROI ボタンで複数の ROI を描画して、複数の ROI を使用できる場合、処理には最後に作成した ROI のみが適用されます。
パラメーター
基本パラメーター
画像:
このパラメーターは、オブジェクトと行間隔を計測する入力画像を表します。
色画像をこのツールの入力として使用すると、最初のチャンネル (赤いチャンネル) のみが処理の対象になります。
エッジコントラスト:
このパラメーターは、背景を基準にしたエッジのコントラストを定義します。このパラメーターはグレイ値として定義され、デフォルト設定値は 10 です。 計測のためにエッジ間隔内で参照オブジェクトが選択されると、そのエッジの「エッジコントラスト」が直ちに設定され、使用されます。しかし、対応するコネクターで値を手動で変更することもできます。
エッジ推移:
このパラメーターは、選択したオブジェクトのエッジペアの推移プロパティを設定します。推移は、外側から内側に決まります。パラメーターの設定値はデフォルトで「任意」です。 エッジ間隔内で計測用に基準オブジェクトのエッジペアを選択すると、「エッジ推移」は直ちに確定します。
「エッジ推移」はエッジ線分のどちら側にマウスポインタがあるか (計測するオブジェクトの 1 つとしてどちら側を選択しているか) によって決まります。グレイ値が高い側にマウスがあると、「エッジ推移」の判定は「暗から明へ」になります。これは、推移の方向が外側から内側であるとみなされるからです。したがって、マウスポインタの位置も、easyTouch による値の決定方法に反映されます。
|
値 |
説明 |
|---|---|
|
明から暗へ |
エッジペアのエッジは、明から暗へ変化します。つまり、エッジは高いグレイ値から低いグレイ値に変化します。 この値が設定されている場合、この推移プロパティを持つエッジのみが計測されます。その他のエッジペアは計測から除外されます。 |
|
暗から明へ |
エッジペアのエッジは、暗から明へ、すなわち、エッジは低い値から高いグレイ値に変化します。 この値が設定されている場合、この推移プロパティを持つエッジのみが計測されます。その他のエッジペアは計測から除外されます。 |
|
任意 |
エッジペアのエッジは、どちらの方向にも変化します。つまり、エッジは高いグレイ値から低いグレイ値、または低いグレイ値から高いグレイ値へのいずれにも変化します。 この値が設定されている場合、すべてのエッジペアが計測に含められます。 |
エッジ幅:
このパラメーターは、エッジ間隔内のエッジの「エッジ幅」を設定します。このパラメーターはピクセル単位で定義され、デフォルト設定値は 2 ピクセルです。行間隔で基準オブジェクトのエッジを選択すると、そのエッジの「エッジ幅」はただちに決まって、適用されます。しかし、対応するコネクターで値を手動で変更することもできます。
追加パラメーター
ROI:
このパラメーターは、処理用の関心領域 (ROI) を定義します。 デフォルトで、 ROI は空に定義されます。ROI を処理に使用する場合は、前のツールの適切な ROI 結果にパラメーターを接続するか、使用可能な ROI ボタンで新しい ROI を画像に描画します。
現在のパラメーター設定を満たすエッジが行間隔にないか ROI のチェックが行われます。すなわち「エッジ推移」を「暗から明へ」に設定すると、このツールは暗から明に変化するエッジ線分が行間隔にないか ROI 方向に検索を行います。適切なエッジが見つかると、それらは計測に使用されます。
このツールがサポートしているのは、単独長方形 ROI の使用のみです。パラメーターに複数の ROI がある場合、処理には、前回作成した ROI のみが適用されます。
アライメントデータ:
このパラメータは、ROI のアライメントに使用するアライメントデータを表します。デフォルトでは、アライメントデータが接続されていないため、効果はありません。特定のアライメントデータを使用するには、マッチングによるアライメント、直線境界でアライメントを決定、画像をアライメント、あるいは 画像を回転 など、パラメータを適切な前のツールの結果に接続します。
キャリブレーションデータ:
このパラメータでは、レンズの歪みの補正と画像平面を基準にしたカメラの位置の補正に必要なキャリブレーションデータを定義します。デフォルトで、キャリブレーションデータは定義されません。キャリブレーションデータを使用するには、キャリブレーションデータがこのツールに送信されるよう、このパラメータを カメラキャリブレーション など、前のツールの適切な結果に接続します。結果は直ちに画像に適用されます。
このツールで「キャリブレーションデータ」を使用する場合、ピクセル値を表すすべての結果は、対応するワールド座標に自動的に変換されます。
参照オブジェクト幅:
このパラメーターは、選択した基準オブジェクトの概算幅 (easyTouch で選択したエッジペア間の距離) を定義します。「参照オブジェクト幅」は、行間隔で他のエッジペアを検索するときに想定される幅を定義します。このパラメータはピクセル単位で定義され、デフォルト設定値は 2 ピクセルです。計測のために行間隔で基準オブジェクトのエッジペアを選択すると、「参照オブジェクト幅」がただちに決まって、適用されます。必要に応じて、対応するコネクターで「参照オブジェクト幅」の値を変更できます。
オブジェクト幅許容範囲:
このパラメーターは、行間隔の許容オブジェクト幅の許容値をパーセント値で定義します。基準オブジェクトとして easyTouch でエッジペアを選択すると、行間隔に所属する可能性のあるエッジペアがさらに検索されます。「オブジェクト幅許容範囲」は、選択した基準オブジェクトの幅を定義する「参照オブジェクト幅」に対して、行間隔における実際のオブジェクト幅との許容誤差を定義します。
「オブジェクト幅許容範囲」の設定値は、デフォルトで 0.9 です。その場合、基準オブジェクトの幅に対するオブジェクト幅の許容誤差は、最大 90% になります。定義した許容誤差内の幅のオブジェクトのすべての平行エッジペアは、計測対象になります。easyTouch で行間隔のエッジペアを選択するとき、このパラメーターの値は調整されません。必要に応じて、対応するコネクターで「オブジェクト幅許容範囲」を変更できます。
結果
基本結果
平行エッジ:
この結果では、行間隔で計測した平行エッジのグラフィック表示が返ります。結果は長方形 ROI として返り、ROI の方向矢印に垂直な ROI 境界が平行エッジを表します。
オブジェクト幅:
この結果では、計測した行間隔のオブジェクトの幅が返ります。これらの値は、各エッジが同じオブジェクトに接している平行エッジ間の距離で定義します。幅はタプルで返り、実数としてピクセル単位で指定します。「キャリブレーションデータ」を使用すると、ワールド座標で距離が返ります。
ギャップ幅:
この結果では、計測した行間隔のオブジェクト間のギャップの幅が返ります。幅は、各エッジが異なるオブジェクトに接する、平行エッジ間の距離で定義します。幅はタプルで返り、実数としてピクセル単位で指定します。「キャリブレーションデータ」を使用すると、ワールド座標で距離が返ります。
中心距離:
この結果では、計測したオブジェクトの中心点間の距離が返ります。距離はタプルで返り、実数としてピクセル単位で指定します。「キャリブレーションデータ」を使用すると、ワールド座標で距離が返ります。見つかって計測したオブジェクトが 1 つだけの場合、空のタプルが返ります。
ツール状態:
「ツール状態」はツール状態の情報を返します。したがって、エラー処理に使うことができます。さまざまなツールの状態結果の詳細については、 ツール状態 結果 のトピックを参照してください。
追加結果
処理時間:
この結果は、ツールの直近の実行の持続時間をミリ秒単位で返します。結果は、追加結果として提供されます。したがって、デフォルトでは非表示になっていますが、ツール結果の横にある 
ボタンを使用して表示できます。詳細については、ツールリファレンス概要の処理時間の節を参照してください。
アプリケーションの例
このツール、以下の MERLIC Vision App 例で使用します:
- calibrate_for_ruler_changed_distance.mvapp
- calibrate_for_ruler_distorted.mvapp
- calibrate_for_ruler_simple.mvapp
