# FindPatMaxPatterns

Sucht nach Merkmalen in einem Bild anhand des trainierten Musters. (Eine trainierte (interne) geometrische Beschreibung eines Objekts, das Sie finden möchten.) FindPatMaxPatterns findet Muster innerhalb eines Bilds auf Basis eines trainierten Musters in einer Musterstruktur.

## FindPatMaxPatterns – 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 Suchbereich im Verhältnis zu einer Vorrichtungeingabe oder im Verhältnis zu einer 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)
Suchbereich | Auch als Inspektionsbereich (ROI) bezeichnet; gibt den Bereich des Bilds an, der einer Analyse unterzogen wird. Doppelklicken Sie auf den Parameter „Bereich“, um einen Interaktiver Grafikmodus zu erstellen, den Sie transformieren und drehen können. Wählen Sie diesen Parameter aus und klicken Sie in der Symbolleiste „Job bearbeiten“ des Eigenschaftsblatts auf die Schaltfläche „Bereich maximieren“, um den Bereich automatisch so zu dehnen, dass er das gesamte Bild einnimmt.
X | Der x-Offset vom Ursprung in Vorrichtungskoordinaten.
Y | Der y-Offset vom Ursprung im Vorrichtungskoordinatensystem.
Breite | Die Abmessung entlang der x-Achse des Bereichs.
Höhe | Die Abmessung entlang der y-Achse des Bereichs.
Winkel | Die Ausrichtung im Vorrichtungskoordinatensystem.
Krümmung | Die Winkelabweichung zwischen der x-Achse des Bereichs und der gegenüberliegenden Grenzlinie des Bereichs.
Externer Bereich | Dieser Parameter verwendet Zellreferenzen auf die Funktionen Annulus, Kreis, Bereich, EditAnnulus, EditCircle, EditCompositeRegion, EditPolygon und EditRegion. Wenn dieser Parameter verwendet wird, ignoriert die Funktion die Einstellungen für Bereich und Vorrichtung und inspiziert den im referenzierten Bereich angegebenen Bildbereich. Wird ein EditCompositeRegion-Steuerelement referenziert, kann der Inspektionsbereich verschiedene Formen beinhalten. Jede Form des zusammengesetzten Bereichs kann dem Inspektionsbereich hinzugefügt oder von ihm entfernt werden (Masking). Hinweis: Wenn dieser Parameter als Referenz auf einen äußeren Bereich eingestellt wurde, um den internen Bereich einer Funktion zu verwenden, muss dieser Parameter manuell auf Null gestellt werden, indem man den Wert 0 anstelle der Zellreferenz einträgt. Andernfalls wird die Funktion weiterhin den externen Bereich referenzieren.
Muster | Dieses Argument muss auf eine Tabellenzelle verweisen, die eine gültige Patterns-Datenstruktur enthält, die über eine TrainPatMaxPattern-Funktion zurückgegeben wird.
Anzahl | Legt die maximale Anzahl der zurückzugebenden Muster-Übereinstimmungen fest (0 bis 1024; Standard = 1).
Akzeptieren | Gibt den Akzeptanzschwellenwert, also die niedrigste Güte einer gültigen Instanz an. Die Güte für eine potentielle Übereinstimmung muss größer sein, als der Wert des Akzeptanzschwellenwerts oder die Übereinstimmung wird nicht zurückgegeben (0 bis 100; Standard = 50).
Kontrast | Gibt den niedrigsten Kontrast einer gültigen Instanz an. Der Kontrast für eine potentielle Übereinstimmung muss größer sein, als der Wert des Kontrastschwellenwerts, oder die Instanz wird nicht berücksichtigt (0 bis 255; Standard = 10). Ein niedriger Kontrastschwellenwert wird für Bilder mit einem niedrigen Kontrast verwendet, während für Bilder mit hohem Kontrast ein hoher Kontrastschwellenwert verwendet wird.
Störung in Auswertung | Legt fest, ob fehlende oder verdeckte Mustermerkmale in der Ergebnisauswertung berücksichtigt werden sollen.
0 = AUS | Störungen sollen nicht in die Auswertung einbezogen werden.
1 = EIN (Standard) | Störungen sollen in die Auswertung einbezogen werden.
Außenbereich | Bestimmt den Prozentanteil von Mustermerkmalen, die außerhalb des Suchbereichs gefunden werden können, ohne die Übereinstimmungsauswertung zu beeinträchtigen (0 bis 100; Standard = 0).
Toleranz suchen | Hier können die Einstellungen für die Suche nach den Mustern angegeben werden, die hinsichtlich des trainierten Musters gedreht oder skaliert sind.
Winkelanfang | Gibt den Winkel in Grad an, ab dem die Suche nach Übereinstimmungen entgegen dem Uhrzeigersinn (-180 bis 180; Standard = -15) begonnen werden soll.
Winkelende | Gibt den Winkel in Grad an, ab dem die Suche nach Übereinstimmungen entgegen dem Uhrzeigersinn (-180 bis 180; Standard = 15) beendet werden soll.
Skalenanfang | Gibt die Skalierung an, ab der die Suche nach Übereinstimmungen begonnen werden soll (1 bis 10000; Standard = 100).
Skalenende | Gibt die Skalierung an, ab der die Suche nach Übereinstimmungen beendet werden soll (1 bis 10000; Standard = 100).
Seitenverhältnis | Beschränkt die Suche nach Übereinstimmungen auf einheitliche Skalierung, oder ermöglicht das Ändern des Seitenverhältnisses auf der x- oder y-Achse. Hinweis: Bei der Auswahl von Nur Einheitsskalierung sind die Parameter Seitenanfang und Seitenende deaktiviert.
0 = Nur Einheitsskalierung
1 = Einheitsskalierung und Skalierungsänderung x-Achse
2 = Einheitsskalierung und Skalierungsänderung y-Achse
Seitenanfang | Legt die minimale Skalierungsänderung fest, ab der die Funktion nach Übereinstimmungen suchen soll, als Prozentanteil des trainierten Musters (1 bis 10000; Standard = 100).
Seitenende | Legt die maximale Skalierungsänderung fest, ab der die Funktion die Suche nach Übereinstimmungen beenden soll, als Prozentanteil des trainierten Musters (1 bis 10000; Standard = 100).
Überlappung suchen | Hier können die Einstellungen für die Suche nach Mustern angegeben werden, die hinsichtlich der Position, Drehung oder Skalierung überlappen.
XY-Überlappung | Legt den erwarteten Positionsunterschied zwischen mehreren überlappenden Mustern ungefähr an derselben x/y-Position als Prozentanteil der Größe des trainierten Musters fest (0 bis 100; Standard = 80). Hinweis: Durch Erhöhen dieses Wertes können mehrere miteinander überlappende Übereinstimmungen desselben Musters gefunden werden.
Winkelüberlappung | Legt den erwarteten Winkel zwischen mehreren gedrehten, überlappenden Mustern ungefähr an derselben X/Y-Position fest. A (0 bis 360; Standard = 360) Hinweis: Falls die Werte der Parameter Winkelanfang und Winkelende gleich sind, dann ist der Parameter Winkelüberlappung deaktiviert. Durch Erhöhen dieses Wertes können mehrere miteinander überlappende Übereinstimmungen desselben Musters gefunden werden.
Skalenüberlappung | Legt den erwarteten Unterschied an Einheitsskalierung zwischen mehreren überlappenden Mustern ungefähr an derselben x/y-Position als Prozentanteil der Größe des trainierten Musters fest (1 bis 10000; Standard = 140). Hinweis: Falls die Werte der Parameter Skalenanfang und Skalenende gleich sind, ist der Parameter Skalenüberlappung deaktiviert. Durch Erhöhen dieses Wertes können mehrere miteinander überlappende Übereinstimmungen desselben Musters gefunden werden.
Seitenüberlappung | Legt den erwarteten Unterschied an Verhältnisskalierung zwischen mehreren überlappenden Mustern ungefähr an derselben x/y-Position als Prozentanteil der Größe des trainierten Musters fest (1 bis 10000; Standard = 140). Hinweis: Der Parameter Seitenüberlappung ist deaktiviert, falls der Parameter Seitenverhältnis auf „Nur Einheitsskalierung“ eingestellt ist oder falls die Werte der Parameter Seitenanfang und Seitenende gleich sind. Durch Erhöhen dieses Wertes können mehrere miteinander überlappende Übereinstimmungen desselben Musters gefunden werden.
Zeitlimit | Definiert den Zeitraum in Millisekunden (0 bis 30000), in dem die Funktion nach Mustern sucht, bevor die Ausführung angehalten und #ERR zurückgegeben wird. Ist als Wert 0 festgelegt, wird diese Einstellung deaktiviert und es gilt kein Zeitlimit.
Algorithmus | Legt den Algorithmus fest, der für die Bearbeitung des Bilds für das trainierte Muster angewendet werden soll.
0 = PatMax | Der PatMax-Algorithmus bietet höhere Genauigkeit als PatQuick, benötigt aber mehr Zeit für die Ausführung.
1 = PatQuick | Der PatQuick-Algorithmus bietet geringere Genauigkeit als PatMax, benötigt aber weniger Zeit für die Ausführung.
2 = Trainiertes Muster (Standard) | Die FindPatMaxPatterns-Funktion verwendet den im Parameter „Algorithmus“ der TrainPatMaxPattern-Funktion angegebenen und im Parameter „Muster“ referenzierten (PatMax oder PatQuick) Algorithmus.
Anzeigen | Legt den Anzeigemodus für die Grafiküberlagerungen auf dem Bild fest.
0 = Alle ausblenden (Standard) | Alle Grafiken werden nur angezeigt, wenn die Zelle mit der FindPatMaxPatterns-Funktion in der Tabelle markiert ist.
1 = Nur Ergebnis-Grafik | Es wird für jedes gefundene Muster immer ein Kreuz angezeigt.
2 = Eingabe- und Ergebnis-Grafik | Der Eingabebildbereich und ein Kreuz für jedes gefundene Muster werden immer angezeigt.
3 = Alles anzeigen: Eingabe, Ergebnis und Übereinstimmungsmerkmale | Der Eingabebildbereich, ein Kreuz für jedes gefundene Muster und die PatMax-Übereinstimmungsmerkmale werden immer angezeigt. Hinweis: Falls PatQuick für den Algorithmusparameter der TrainPatMaxPattern-Funktion angegeben wurde, werden Übereinstimmungsmerkmale nicht angezeigt. Grüne Übereinstimmungsmerkmale = Übereinstimmung zwischen 67 und 100 Prozent. Gelbe Übereinstimmungsmerkmale = Übereinstimmung zwischen 20 und 66 Prozent. Rote Übereinstimmungsmerkmale = Übereinstimmung unter 20 Prozent.

## FindPatMaxPatterns – Ausgaben

Rückgabewert | Eine Patterns-Datenstruktur mit dem Modell und einer Liste von Musterreaktionen sortiert nach ihrer Güte, oder #ERR, wenn mindestens ein Eingabeparameter ungültig ist oder keine Übereinstimmungsmerkmale gefunden wurden.
Ergebnisse | Wenn FindPatMaxPatterns in eine Zelle eingefügt wird, wird im Arbeitsblatt eine Ergebnistabelle erstellt. Hinweis: Wenn Sie sich im Eigenschaftsblatt der Funktion befinden, werden Informationen mit Anregungen zur besseren Mustersuche bereitgestellt. Hier finden Sie eine Liste der möglichen Informationen: [Wert] Ergebnisse wurden wegen zu wenig Kontrast gelöscht. [Wert] Ergebnisse wurden aufgrund der Nähe zu genaueren Ergebnissen gelöscht. [Wert] Ergebnisse wurden wegen zu vielen Störungen gelöscht. Das trainierte Muster enthält zu wenige Merkmale für die aktuellen Parametereinstellungen. Verwenden Sie zum Einfügen von Informationen in die Tabelle die GetInfoString-Datenzugriffsfunktion.

## FindPatMaxPatterns Vision Data Access functions

Die folgenden Patterns Vision Data Access functions werden automatisch in die Tabelle eingefügt, um die Ergebnistabelle zu erstellen:

Label | Funktion | Beschreibung
X | GetX(Muster, Index) | Die x-Koordinate der Musterposition.
Y | GetY(Muster, Index) | Die y-Koordinate der Musterposition.
Winkel | GetAngle(Muster, Index) | Dies ist die Ausrichtung der Musterposition.
Skalieren | GetScale(Muster, Index) | Die Größe des gefundenen Musters verglichen mit dem trainierten Modell, als Prozentsatz der Modellgröße.
Güte | GetScore(Muster, Index) | Die Güte der Musterreaktionen.