FindCircle

Sucht nach einer einzelnen kreisförmigen Kante innerhalb eines (kreisringförmigen) Bildbereichs. FindCircle bildet eindimensionale Projektionen der Bildregion durch Summieren von Pixelwerten auf konzentrischen Kreisen, die in der Richtung von immer größeren Radien gescannt werden. Kantenübergänge werden aus den projizierten Bilddaten extrahiert.

FindCircle – Eingaben

Parameter

Beschreibung

Bild

Dieser Parameter muss auf eine Tabellenzelle verweisen, die eine Bild-Datenstruktur enthält. Standardmäßig verweist dieser Parameter auf A0, die Zelle mit der Datenstruktur. Dieser Parameter kann auch andere Image-Datenstrukturen referenzieren, z. B. solche, die von den Image Datenzugriffsfunktionen oder Koordinatenumrechnungsfunktionen zurückgegeben werden.

Vorrichtung

Definiert den Inspektionsbereich (ROI) relativ zu einer Vorrichtung als Eingabe oder die Ausgabe des Bildkoordinatensystems einer Vision Tools-Funktion. Wenn man den ROI relativ zu einer Vorrichtung bestimmt, stellt man sicher, dass beim Verdrehen oder Umsetzen der Vorrichtung auch der Inspektionsbereich im Verhältnis zur Vorrichtung verdreht oder umgesetzt wird.

Die Standardeinstellung ist (0,0,0), die oberste linke Ecke des Bilds.

X	Der x-Offset in Bildkoordinaten.
Y	Der y-Offset in Bildkoordinaten.
Winkel	Die Drehung von der x-Bildachse im Bildkoordinatensystem. (+/-360 Grad im Uhrzeigersinn)

Kreisring

Auch als Inspektionsbereich (ROI) bezeichnet; gibt den Bereich des Bilds an, der einer Analyse unterzogen wird; erstellt einen ringförmigen Bildbereich, der verschoben und gedreht werden kann. Ist dieser Parameter ausgewählt, können Sie in der Symbolleiste des Eigenschaftsblatts auf die Schaltfläche „Bereich maximieren“ klicken, damit der Bereich automatisch gedehnt wird, sodass er das gesamte Bild einnimmt.

X	Der X-Offset vom Ursprung im Vorrichtungskoordinatensystem.
Y	Der y-Offset vom Ursprung im Vorrichtungskoordinatensystem.
Innenradius	Die Größe des Innenradius.
Außenradius	Die Größe des Außenradius.

Hinweis: Die Parameter Vorrichtung und Ring müssen innerhalb der Bildgrenzen festgelegt werden. Andernfalls gibt die Funktion #ERR zurück.

Polarität

Gibt die Polarität der zu lokalisierenden Kante relativ zur Scanrichtung des Kantenbereichs an. Die Funktion gibt nur Kanten der angegebenen Polarität zurück.

0 = Schwarz -> Weiß	Gibt an, dass die Kantenpolarität Schwarz -> Weiß ist.
1 = Weiß -> Schwarz	Gibt an, dass die Kantenpolarität Weiß -> Schwarz ist.
2 = Beide (Standard)	Gibt an, dass die Kantenpolarität entweder Schwarz -> Weiß oder Weiß -> Schwarz sein kann.

Suchkriterium

Gibt die Kantenauswahltechnik an, die die Funktion verwendet, um eine Kante unter mehreren Kantenkandidaten auszuwählen.

0 = stärkste Kante (Standard)	Gibt an, dass die Kante mit der höchsten Güte die höchste Berücksichtigung erhält.
1 = kleinster Kreis	Legt fest, dass der kleinste Kreis am meisten berücksichtigt werden soll.
2 = größter Kreis	Legt fest, dass der größte Kreis am meisten berücksichtigt werden soll.

Akzeptanzschwelle

Gibt den minimal akzeptablen Kantenkontrast (0 bis 100; Standard = 25) an. Der Kontrastwert wird vom Graustufen-Histogramm innerhalb des Bereichs auf eine Skala von 0 bis 100 normalisiert. Die Funktion lehnt alle Kanten ab, deren Kontrastgüte unter diesem Wert liegt.

Güte normalisieren

Gibt an, ob die Kantengüten durch das Graustufen-Histogramm des Bereichs normalisiert werden. Bei Aktivierung von Güte normalisieren werden Rohkantengüten anhand des maximalen Kontrasts normalisiert, der innerhalb des Bildbereichs gefunden wird, wobei die folgende Formel verwendet wird:

Ergebnis = (Rohkantengüte) x (100/max. Kontrast)

Wobei Rohkantengüte die Graustufendifferenz über die gesamte Kante und Max. Kontrast die Differenz zwischen der maximalen und minimalen Graustufe (0 bis 255) innerhalb des Bildbereichs ist.

Bei Deaktivierung von Güte normalisieren werden Kanten mit niedrigem Kontrast niedriger bewertet als Kanten mit hohem Kontrast. Dabei wird folgende Formel verwendet:

Punktzahl = (Rohkantengüte) x (100/255)

0 = AUS	Die Güte nicht normalisieren.
1 = EIN (Standard)	Die Güte normalisieren.

Hinweis: Tipp: Dieser Parameter ist nützlich, um Kanten in einem Bereich mit niedrigem Kontrast zu finden. Wenn Sie davon ausgehen, dass die zu erkennenden Kanten nur einen hohen Kontrast aufweisen, deaktivieren Sie diesen Parameter.

Kantenbreite

Gibt den Abstand in Pixel (1 bis 50; Standard = 3) an, über den hinaus ein Kantenübergang stattfindet. Kantenbreite wird zum Filtern des Bilds verwendet, bevor die Kanten extrahiert werden.

Anzeigen

Legt den Anzeigemodus für FindCircle-Grafiküberlagerungen fest, die über dem Bild angezeigt werden.

0 = Alle ausblenden (Standard)	Alle Grafiken werden nur angezeigt, wenn die Zelle mit der FindCircle-Funktion in der Tabelle markiert ist.
1 = Nur Ergebnis-Grafik	Die kreisförmige Kante wird immer angezeigt.
2 = Eingabe- und Ergebnis-Grafik	Die Eingabebildregion und die kreisförmige Kante werden immer angezeigt.
3 = Alles anzeigen: Eingabe, Ergebnis und Diagramm	Die Eingabebildregion, die kreisförmige Kante und das Kantenverlaufsdiagramm werden immer angezeigt. Hinweis: Das Kantenverlaufsdiagramm ist ein andockbares Fenster. Weitere Informationen hierzu finden Sie im Thema Tabelleneditor – Diagramme.

FindCircle – Ausgaben

Rückgabewert

Eine Kante-Datenstruktur, die eine einzelne kreisförmige Kante enthält, oder #ERR, wenn einer der Eingabeparameter ungültig ist.

Ergebnisse

Wenn FindCircle erstmals in eine Zelle eingefügt wird, wird mit den folgenden Edges Datenzugriffsfunktionen in der Tabelle eine Ergebnistabelle erstellt.

Label	Funktion	Beschreibung
CentX	GetX(Kanten, 0, 0)	Die mittlere x-Koordinate.
CentY	GetY(Kanten, 0, 0)	Die mittlere y-Koordinate.
Radius	GetRadius(Kanten, 0)	Der Radius.
Güte	GetScore(Kanten, 0)	Die Kontrastgüte der Kante. Kontrast ist positiv im Falle von Schwarz nach Weiß-Übergängen und negativ im Fall von Weiß nach Schwarz-Übergängen.