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.