Parallele Kanten messen
Mit diesem Tool können Sie parallele Kanten messen, um beispielsweise die Breite eines Objekts zu messen.
Für dieses Tool sind easyTouch und easyTouch+ verfügbar. Dies bedeutet, dass Sie die Kanten für die Messung interaktiv im Bild auswählen können und die entsprechenden Parameter automatisch angepasst werden. Das Tool fügt parallele Kanten basierend auf den angegebenen Parametern und Kanten im Bild unabhängig davon ein, ob diese parallel sind. Bewegen Sie den Mauszeiger über eine der parallelen Kanten, die gemessen werden sollen. MERLIC zeigt eine Vorschau der ROI und dem darin enthaltenen vorgeschlagenen Kantenpaar an. Die Position des Mauszeigers beeinflusst die Suche nach der entsprechenden parallelen Kante, d. h. die parallele Kante wird abhängig davon bestimmt, auf welcher Seite der Mauszeiger positioniert wurde. MERLIC sucht nach der parallelen Kante auf der Seite, auf der sich die Maus befindet. Daher ändert sich die Vorschau der vorgeschlagenen Kanten, wenn Sie die Maus von einer Seite der Kante zur anderen Seite bewegen. Klicken Sie auf das Kantenpaar, wenn Sie die Kanten der easyTouch-Vorschau messen möchten, um die Auswahl zu bestätigen. Die Parameter werden automatisch an die ausgewählte Kante angepasst. Sie können jedoch weiterhin an den entsprechenden Verbindungsstellen manuell angepasst werden.
Um weitere parallele Kanten zur Messung hinzuzufügen, können Sie easyTouch+ verwenden, indem Sie die STRG-Taste drücken und das zusätzliche Kantenpaar auswählen. MERLIC überprüft automatisch, ob das ausgewählte Kantenpaar zu den aktuellen Parametereinstellungen der vorherigen Auswahl passt. Wenn dies nicht der Fall ist, weil sich der Mauszeiger z. B. über einem Kantenpaar mit einem anderen Kantenübergang befindet, zeigt MERLIC sofort an, dass die betreffenden Kanten von easyTouch+ ignoriert werden.
Alternativ können Sie ROIs für die Messung verwenden. Wenn die ROI geeignete Kantenpaare enthält, die den aktuellen Parametereinstellungen entsprechen, werden diese automatisch ermittelt und gemessen. Die ROI bestimmt auch Anfangs- und Endpunkt und somit die Länge der Kante. Verwenden Sie kleinere ROIs, um Kanten entlang einer gekrümmten Linie zu erkennen.
Beachten Sie die unterschiedlichen Farben von ROI und Kantenpaar. Die ROI-Farbe wechselt zwischen rot und grün. Sie zeigt an, ob die Kanten in der ROI eindeutig sind oder nicht (siehe folgende Tabelle).
|
Beispiel |
Beschreibung |
|---|---|
|
|
Eine grün hervorgehobene ROI stellt ein eindeutiges Kantenpaar dar. |
|
|
Eine rot hervorgehobene ROI weist auf ein mehrdeutiges Kantenpaar hin, weil in der ROI viele parallele Kanten vorhanden sind. |
Die Farbe der vorgeschlagenen parallelen Kanten wechselt wie unten gezeigt zwischen blau und rot. Sie kennzeichnet den Kantenübergang des vorgeschlagenen Kantenpaars.
|
Beispiel |
Beschreibung |
|---|---|
|
|
Die vorgeschlagenen Kanten in der Vorschau werden blau hervorgehoben, wenn zuvor kein Kantenpaar trainiert wurde oder der Kantenübergang des zuvor trainierten Kantenpaars mit dem Kantenübergang des aktuell trainierten Kantenpaars übereinstimmt. |
|
|
Bei Verwendung von easyTouch+ weist eine rote Kantenfarbe auf einen gegenüberliegenden Kantenübergang im Vergleich zum zuvor trainierten hin. |
Parameter
Standardparameter
Bild:
Dieser Parameter stellt das Eingabebild dar, in dem die parallelen Kanten gemessen werden.
Bei der Verwendung eines Farbbilds als Eingabebild für dieses Tool wird nur der erste Kanal, d. h. der rote Kanal, für die Verarbeitung verwendet.
Kantenkontrast:
Dieser Parameter definiert den Kontrast der parallelen Kanten in Bezug auf den Hintergrund. Der Parameter wird in Grauwerten angegeben und ist standardmäßig auf 10 festgelegt. Wird ein paralleles Kantenpaar für die Messung ausgewählt, wird der „Kantenkontrast“ dieses Kantenpaars sofort bestimmt und übernommen. Werden weitere parallele Kantenpaare über easyTouch+ hinzugefügt, wird der „Kantenkontrast“ mit jedem Kantenpaar, das der Auswahl hinzugefügt wird, automatisch angepasst. Sie können den Wert jedoch auch manuell über die entsprechende Verbindungsstelle ändern.
Kantenbreite:
Dieser Parameter definiert die Breite der Kanten. Er wird in Pixeln angegeben und ist standardmäßig auf 2 px festgelegt. Wird ein Kantenpaar für die Messung ausgewählt, wird die „Kantenbreite“ seiner Kanten sofort bestimmt und übernommen. Werden weitere parallele Kanten über easyTouch+ hinzugefügt, wird die „Kantenbreite“ mit jedem Kantenpaar, das der Auswahl hinzugefügt wird, automatisch angepasst. Sie können den Wert jedoch auch manuell über die entsprechende Verbindungsstelle ändern.
Kantenübergang:
Dieser Parameter definiert die Übergangseigenschaft am Kantenpaar. Der Übergang wird von innen nach außen bestimmt. Der Parameter ist standardmäßig auf „beliebig“ festgelegt. Bei Auswahl eines Kantenpaars für die Messung wird der „Kantenübergang“ sofort bestimmt und für jedes Kantenpaar, das der Auswahl hinzugefügt wird, automatisch angepasst.
Der „Kantenübergang“ wird abhängig davon bestimmt, auf welcher Seite des Kantenstücks sich der Mauszeiger befindet und somit auf welcher Seite die parallele Kante gesucht wird. Wird die Maus auf der Seite mit den höheren Grauwerten positioniert, wird der „Kantenübergang“ als „dunkel auf hell“ eingestuft, da der Übergang von außen nach innen bestimmt wird. Somit beeinflusst die Position der Maus auch die Art und Weise, wie der Wert von easyTouch bestimmt wird.
|
Wert |
Beschreibung |
|---|---|
|
hell auf dunkel |
Die Kanten des Kantenpaars ändern sich von hell auf dunkel, d. h. von höheren zu niedrigeren Grauwerten. Wenn dieser Wert eingestellt ist, werden nur Kanten mit dieser Eigenschaft gemessen. Andere Kantenpaare werden nicht in die Messung einbezogen. |
|
dunkel auf hell |
Die Kanten des Kantenpaars ändern sich von dunkel auf hell, d. h. von niedrigeren zu höheren Grauwerten. Wenn dieser Wert eingestellt ist, werden nur Kanten mit dieser Eigenschaft gemessen. Andere Kantenpaare werden nicht in die Messung einbezogen. |
|
beliebig |
Die Kanten des Kantenpaars können sich in beide Richtungen ändern, d. h. von höheren zu niedrigeren Grauwerten und umgekehrt. Wenn dieser Wert eingestellt ist, werden alle Kantenpaare in die Messung einbezogen. |
Zusätzliche Parameter
ROI:
Dieser Parameter definiert die ROI (Region Of Interest) für die Verarbeitung. Der Parameter „ROI“ ist standardmäßig als leer definiert. Wenn Sie eine ROI für die Verarbeitung verwenden möchten, müssen Sie den Parameter mit einem geeigneten ROI-Ergebnis eines vorherigen Tools verbinden oder mit den verfügbaren ROI-Schaltflächen neue ROIs im Bild zeichnen.
Die ROI wird nach parallelen Kanten durchsucht, die zu den aktuellen Parametereinstellungen passen. Wenn der „Kantenübergang“ beispielsweise auf „dunkel auf hell“ festgelegt ist, ermittelt das Tool entlang der ROI-Orientierung, ob parallele Kanten vorhanden sind, die von dunkel nach hell wechseln. Werden geeignete Kanten gefunden, werden sie für die Messung verwendet.
Ausrichtungsdaten:
Dieser Parameter stellt die Ausrichtungsdaten dar, die zum Ausrichten der ROI verwendet werden. Ausrichtungsdaten sind standardmäßig nicht verbunden, sodass keine Auswirkung sichtbar ist. Wenn Sie bestimmte Ausrichtungsdaten verwenden möchten, müssen Sie den Parameter mit einem geeigneten Ergebnis eines vorherigen Tools verbinden, z. B. Ausrichtungsdaten mit Matching bestimmen, Ausrichtungsdaten mittels geradem Rand bestimmen, Bild ausrichten oder Bild drehen.
Kalibrierdaten:
Dieser Parameter definiert die Kalibrierdaten, die für die Korrektur eventueller Linsenverzerrungen sowie der Position der Kamera in Bezug auf die Bildebene erforderlich sind. Standardmäßig sind keine Kalibrierdaten definiert. Wenn Sie Kalibrierdaten verwenden möchten, müssen Sie den Parameter mit einem geeigneten Ergebnis eines vorherigen Tools, z. B. Kamera kalibrieren, verbinden, damit die Kalibrierdaten an dieses Tool übertragen werden. Sie werden sofort auf das Bild angewendet.
Falls „Kalibrierdaten“ für dieses Tool verwendet werden, werden alle Ergebnisse, die Pixelwerte darstellen, automatisch in die entsprechenden Weltkoordinaten transformiert.
Fehlgeschlagene Messung:
Dieser Parameter legt fest, welcher Wert im Ergebnis für „Objektbreite“ zurückgegeben wird, falls keine Messung durchgeführt werden konnte. Der Parameter ist standardmäßig auf „ignorieren“ festgelegt. Sie können den Parameter an der entsprechenden Verbindungsstelle auf die folgenden Werte einstellen.
|
Wert |
Beschreibung |
|---|---|
|
ignorieren |
Es wird kein Wert zurückgegeben, wenn keine Messung durchgeführt werden konnte. |
|
-1 |
Es wird -1 zurückgegeben, wenn keine Messung durchgeführt werden konnte. Sie können den Wert direkt im Eingabefeld der Verbindungsstelle durch eine beliebige Zahl oder Zeichenfolge ersetzen, die ausgegeben werden soll. |
|
* |
Wenn keine Messung durchgeführt werden konnte, wird * zurückgegeben. Sie können den Wert direkt im Eingabefeld der Verbindungsstelle durch eine beliebige Zahl oder Zeichenfolge ersetzen, die ausgegeben werden soll. |
Ergebnisse
Standardergebnisse
Parallele Kanten:
Dieses Ergebnis gibt die grafische Darstellung der gemessenen parallelen Kanten aus. Diese werden als rechteckige ROI ausgegeben, in der die Ränder der ROI (senkrecht zum ROI-Orientierungspfeil) die parallelen Kanten darstellen.
Objektbreite:
Dieses Ergebnis gibt den Abstand zwischen den gemessenen parallelen Kanten aus. Die Ausgabe erfolgt als reelle Zahl in Pixeln. Falls „Kalibrierdaten“ verwendet werden, wird der Abstand in Weltkoordinaten ausgegeben. Werden mehrere parallele Kantenpaare gemessen, werden die zugehörigen Breiten als Tupel ausgegeben.
Toolstatus:
„Toolstatus“ gibt Informationen zum Status des Tools aus und kann daher für die Fehlerbehandlung verwendet werden. Weitere Informationen zu den verschiedenen Toolstatus-Ergebnissen finden Sie unter Toolstatus-Ergebnis.
Zusätzliche Ergebnisse
Verarbeitungszeit:
Dieses Ergebnis gibt die Dauer der letzten Ausführung des Tools in Millisekunden aus. Das Ergebnis wird als zusätzliches Ergebnis bereitgestellt. Es ist daher standardmäßig ausgeblendet, kann aber über die Schaltfläche neben den Toolergebnissen angezeigt werden. Weitere Informationen finden Sie im Abschnitt Verarbeitungszeit in der Tool-Referenz-Übersicht.
Anwendungsbeispiele
Dieses Tool wird in den folgenden MERLIC-Vision-App-Beispielen verwendet:
- measure_distance_to_center_led.mvapp