Längstes Kantenstück messen

Mit diesem Tool können Sie die längsten Kantenstücke messen.

Die Ausgabe erfolgt als Geradenstück-ROIs, die in den Tools Kreis zu Geradenstück vermessen, Geradenstück zu Punkt vermessen und Geradenstück zu Geradenstück vermessen verwendet werden können. Das Tool gibt auch die „Geradenstücklänge“ und die „Geradenstückorientierung“ in Bezug auf die virtuelle horizontale Linie aus. Das Tool kann auch dann eine Geradenstück-ROI ausgeben, wenn das Bild keine vollständige oder glatte Kante enthält.

Für dieses Tool sind easyTouch und easyTouch+ verfügbar. Dies bedeutet, dass Sie das längste zu messende Kantenstück interaktiv im Bild auswählen können. Bewegen Sie die Maus über eine Kante, deren längstes Geradenstück gemessen werden soll. MERLIC zeigt eine Vorschau des vorgeschlagenen längsten Kantenstücks an. Klicken Sie auf die Kante, wenn Sie das in der Vorschau angezeigte Geradenstück messen möchten, um die Auswahl zu bestätigen. Die Parameter werden automatisch an das ausgewählte Geradenstück angepasst. Sie können jedoch weiterhin an den entsprechenden Verbindungsstellen manuell angepasst werden.

Alternativ können Sie ROIs für die Messung verwenden. Zeichnen Sie eine ROI im Bild. Wenn die ROI Kantenstücke enthält, die den aktuellen Parametereinstellungen entsprechen, werden diese automatisch ermittelt und gemessen. Ohne ROI sucht das Tool das längste Kantenstück im ganzen Bild, sobald ein Bild verbunden ist. 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.

Parameter

Standardparameter

Bild:

Dieser Parameter stellt das Eingabebild dar, in dem das längste Kantenstück gemessen wird. Ist aus dem Ergebnis eines vorherigen Tools ein Bild vorhanden, wird dieses automatisch verbunden und als Eingabebild verwendet.

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 des längsten Kantenstücks in Bezug auf den Hintergrund. Er wird in Grauwerten angegeben und ist standardmäßig auf 20 festgelegt. Wird ein Kantenstück für die Messung ausgewählt, wird der „Kantenkontrast“ dieses Geradenstücks sofort bestimmt und übernommen. Werden weitere Kantenstücke über easyTouch+ hinzugefügt, wird der „Kantenkontrast“ mit jedem Kantenstück, 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 des längsten Kantenstücks. Er wird in Pixeln angegeben und ist standardmäßig auf 2 px festgelegt. Wird ein Kantenstück für die Messung ausgewählt, wird die „Kantenbreite“ dieses Geradenstücks sofort bestimmt und übernommen. Werden weitere Kantenstücke über easyTouch+ hinzugefügt, wird die „Kantenbreite“ mit jedem Geradenstück, das der Auswahl hinzugefügt wird, automatisch angepasst. Sie können den Wert jedoch auch manuell über die entsprechende Verbindungsstelle ändern.

Zusätzliche Parameter

ROI:

Dieser Parameter definiert die ROI für die Verarbeitung. Bildteile außerhalb der Vereinigung von ROI und „Verarbeitungsbereich“ werden nicht verarbeitet.Wenn zudem einer der Bereiche leer ist, wird der Bildteil, der innerhalb des jeweils anderen liegt, verarbeitet. Sind beide leer, wird das gesamte Bild verarbeitet. Bei Verwendung von easyTouch zur Bestimmung der Parameter wird jedoch nur der Parameter „Verarbeitungsbereich“ für die Messung verwendet.

Die ROI ist standardmäßig als leere ROI definiert. Wenn Sie eine nicht leere 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 zeichnen.

Die Vereinigung der definierten „ROI“ und dem „Verarbeitungsbereich“ wird nach einem Kantenstück durchsucht, das zu den aktuellen Parametereinstellungen passt. Wenn der „Kantenübergang“ beispielsweise auf „dunkel auf hell“ festgelegt ist, ermittelt das Tool entlang der ROI-Orientierung, ob ein Kantenstück vorhanden ist, das von dunkel nach hell wechselt. Werden geeignete Kantenstücke gefunden, werden sie für die Messung verwendet.

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.

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.

Fehlgeschlagene Messung:

Dieser Parameter legt fest, welcher Wert im Ergebnis für „Geradenstücklänge“ und „Geradenstückorientierung“ 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.

Verarbeitungsbereich:

Dieser Parameter definiert die Region für die Verarbeitung. Bildteile außerhalb der Vereinigung von ROI und „Verarbeitungsbereich“ werden nicht verarbeitet. Wenn zudem einer der Bereiche leer ist, wird der Bildteil, der innerhalb des jeweils anderen liegt, verarbeitet. Sind beide leer, wird das gesamte Bild verarbeitet.

„Verarbeitungsbereich“ ist standardmäßig als leere Region definiert. Wenn Sie eine „Verarbeitungsbereich“ angeben möchten, müssen Sie den Parameter mit einem geeigneten Ergebnis eines vorherigen Tools verbinden, damit die Region an dieses Tool übertragen wird.

Bei Verwendung von easyTouch zur Bestimmung der Parameter wird nur der Parameter „Verarbeitungsbereich“ für die Messung verwendet. Ist kein „Verarbeitungsbereich“ definiert, wird das gesamte Bild für die Messung verwendet.

Ergebnisse

Standardergebnisse

Geradenstück:

Dieses Ergebnis gibt die grafische Darstellung des längsten gemessenen Kantenstücks aus. Die Ausgabe erfolgt als Geradenstück-ROI. Wenn mehrere Kantenstücke gemessen wurden, enthält das „Geradenstück“ die ROIs aller längsten Kantenstücke.

Geradenstücklänge:

Dieses Ergebnis gibt die Länge des längsten gemessenen Kantenstücks aus. Die Ausgabe erfolgt als reelle Zahl in Pixeln. Falls „Kalibrierdaten“ verwendet werden, wird die Länge in Weltkoordinaten ausgegeben. Werden mehrere längste Kantenstücke gemessen, werden die zugehörigen Längen als Tupel ausgegeben.

Geradenstückorientierung:

Dieses Ergebnis gibt den Winkel zwischen dem längsten gemessenen Kantenstück und der virtuellen horizontalen Linie durch den Mittelpunkt des Kantenstücks aus. Die Ausgabe erfolgt als reelle Zahl in Grad. Der Mittelpunkt des Geradenstücks bildet das Rotationszentrum. Liegt der Endpunkt des Geradenstücks über der horizontalen Achse, ergibt sich der Winkel (mit positivem Vorzeichen) aus der Drehung der horizontalen Linie gegen den Uhrzeigersinn zum längsten Kantenstück. Liegt der Endpunkt des Geradenstücks unter der horizontalen Achse, ergibt sich der Winkel (mit negativem Vorzeichen) aus der Drehung der horizontalen Linie im Uhrzeigersinn zum längsten Kantenstück.

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

Kantenkontur:

Dieses Ergebnis gibt die Kontur des Kantenstücks aus, das für die Messung verwendet wurde.

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_segment_circle_calibrated.mvapp