# 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 | This parameter must reference a spreadsheet cell that contains an Bild data structure; by default, this parameter references A0, the cell containing the data structure. This parameter can also reference other Image data structures, such as those returned by the Image Vision Data Access functions or Koordinatenumrechnungsfunktionen.
Vorrichtung | Definiert den Inspektionsbereich (ROI) relativ zu einer Vorrichtung als Eingabe oder die Ausgabe des Bildkoordinatensystems einer Vision Tools-Funktion. Wenn man den Inspektionsbereich (ROI) relativ zu einer Vorrichtung bestimmt, stellt man sicher, dass beim Drehen oder Umsetzen der Vorrichtung auch der Inspektionsbereich (ROI) im Verhältnis zur Vorrichtung gedreht 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)
Ring | 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 in Vorrichtungskoordinaten.
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 | Der Eingabebildbereich und die kreisförmige Kante werden immer angezeigt.
3 = Alles anzeigen: Eingabe, Ergebnis und Diagramm | Der Eingabebildbereich, 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 Vision Data Access functions 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.