# TrainPatMaxRedLine

Extrahiert und trainiert ein Muster aus einem Bild für die Verwendung mit der FindPatMaxRedLine-Funktion.

Hinweis: Ein trainiertes Muster beansprucht etwa 1 MB, wenn es den Standard-Musterbereich (320 X 440) verwendet, obwohl die Mustergröße stark von der Größe des trainierten Musters abhängt.

## TrainPatMaxRedLine – 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 (Standard = 0) | Der x-Offset in Bildkoordinaten.
Y (Standard = 0) | Der y-Offset in Bildkoordinaten.
Winkel (Standard = 0) | Die Drehung von der x-Bildachse im Bildkoordinatensystem. (+/-360 Grad im Uhrzeigersinn)
Externe Region | 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 (Standard = 440) | Die Abmessung entlang der x-Achse des Bereichs.
Höhe (Standard = 320) | Die Abmessung entlang der y-Achse des Bereichs.
Winkel (Standard = 0) | Die Ausrichtung im Vorrichtungskoordinatensystem.
Krümmung (Standard = 0) | Die Winkelabweichung zwischen der x-Achse des Bereichs und der gegenüberliegenden Grenzlinie des Bereichs.
Hinweis: Die Parameter Vorrichtung und Bereich müssen innerhalb der Bildgrenzen festgelegt werden. Andernfalls gibt die Funktion #ERR zurück.
Externer Bereich | Dieser Parameter verwendet Zellreferenzen für eine Tabellenzelle, die eine Annulus-, Kreis-, Bereich-, EditAnnulus-, EditCircle-, EditCompositeRegion-, EditPolygon-, oder EditRegion-Funktion beinhaltet. 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.
Musterausgangspunkt | Gibt den x- und den y-Wert des Ausgangspunkts des Trainingsmusters als Offset von der Mitte des Trainingsbereichs an.
Offset x (Standard = 0) | Legt den x-Offset vom Mittelpunkt des trainierten Musters fest.
Offset y (Standard = 0) | Legt den y-Offset vom Mittelpunkt des trainierten Musters fest.
Grob automatisch auswählen | Wählt, wenn diese Option aktiviert ist, automatisch die Granularität des Musters aus, die während der groben Suchphase verwendet werden soll. Eine grobe Granularität wird zum Auffinden großer Merkmale verwendet, um eine ungefähre Musterübereinstimmung in einem Laufzeitbild schnell zu finden.
0 = AUS | Grobe Granularität wird verwendet
1 = EIN (Standard) | Die Granularität des Musters wird automatisch ausgewählt.
Fein automatisch auswählen | Wählt, wenn diese Option aktiviert ist, automatisch die Granularität des Musters aus, die während der Feinsuchphase verwendet werden soll. Eine feine Granularität wird zum Auffinden kleiner Merkmale verwendet, um die Position des Musters präzise zu bestimmen.
0 = AUS | Es wird eine feine Granularität verwendet.
1 = EIN (Standard) | Die Granularität des Musters wird automatisch ausgewählt.
Grobe Granularität | Gibt die grobe Granularität in Pixel an. Eine grobe Granularität wird zum Auffinden großer Merkmale verwendet, um eine ungefähre Musterübereinstimmung in einem Laufzeitbild schnell zu finden (1 bis 30; 4 = Standard). Hinweis: Der Parameter „Grob automatisch auswählen“ ist standardmäßig aktiviert. Deaktivieren Sie ihn, um diesen Parameter zu aktivieren.
Feine Granularität | Gibt die Feinkörnigkeit in Pixel an. Feine Granularität wird zum Auffinden kleiner Merkmale verwendet, um die Position des Musters präzise bestimmen zu können (1 bis 10; 1 = Standard). Hinweis: Der Parameter „Fein automatisch auswählen“ ist standardmäßig aktiviert. Deaktivieren Sie ihn, um diesen Parameter zu aktivieren. Der Wert für Feine Granularität kann nicht höher als der Wert für Grobe Granularität eingestellt werden.
Merkmalschwellwert | Gibt den minimalen Kontrast der trainierten Merkmale an. Wählen Sie einen niedrigeren Wert, damit auch weitere Merkmale mit niedrigem Kontrast trainiert werden können, oder erhöhen Sie den Wert, um diese zu ignorieren (1 bis 100; 20 = Standard).
Ereignis trainieren | Gibt Zellreferenzen für eine Zelle an, die einen Trigger für ein Modelltrainingsereignis enthält. Hinweis: Das Training erfolgt, wenn das Eigenschaftsblatt geöffnet wird oder wenn ein Ereignis-Trigger, wie z. B. eine Schaltfläche oder eine andere bedingungsabhängig aktivierte Zelle nicht Null ist.
Trainingsbild wiederverwenden | Gibt an, ob das zum Trainieren des Musters verwendete Bild gespeichert und beim Ändern der Parameter für die Mustereinstellungen (Musterausgangspunkt, Grob automatisch auswählen, Fein automatisch auswählen, Grobe Granularität, Feine Granularität oder Rauschschwellenwert) verwendet wird.
0 = AUS (Standard) | Das aktuelle Bild (also das im Parameter „Bild“ angegebene Bild) wird zum Trainieren/Neutrainieren des Musters verwendet.
1 = EIN | Das Bild, das ursprünglich zum Trainieren des Musters verwendet wurde, wird zum erneuten Trainieren des Musters verwendet, wenn die Parameter „Musterursprung“, „Grob automatisch auswählen“, „Fein automatisch auswählen“, „Grobe Granularität“, „Feine Granularität“ und/oder „Rauschenschwellenwert“ geändert werden. Wenn das erste Mal aktiviert, wird das durch den Parameter „Bild“ bestimmte Bild für das Trainieren des Musters verwendet und eine Kopie des Bilds im Job gespeichert. Alle nachfolgenden Änderungen, die an den Parametern „Musterursprung“, „Grob automatisch auswählen“, „Fein automatisch auswählen“, „Grobe Granularität“, „Feine Granularität“ oder „Rauschschwellenwert“ vorgenommen werden, werden unter Verwendung des gespeicherten Bilds vorgenommen. Hinweis: Wenn dieser Parameter aktiviert ist, und die Eingabe für die Vorrichtung verändert wird oder der Musterbereich (oder der externe Bereich) verschoben oder verändert wird, wird die Funktion den Trainingsbereich im Eingangsbild anpassen, das neue Bild speichern und das Muster neu trainieren. Wenn der Parameter „Trainingsbild wiederverwenden“ auf EIN (aktiviert) gestellt wird, aber es wurde noch kein Muster trainiert, dann wird die Funktion solange #ERR zurückgeben, bis der Parameter auf AUS (deaktiviert) eingestellt und ein neues Muster trainiert wurde.
Zeitlimit | Gibt den Zeitraum in Millisekunden (0 bis 30000); 0 = Standard an, in dem die Funktion nach Mustern sucht, bevor die Ausführung angehalten und #ERR zurückgegeben wird. Mit dem Wert 0 ist die Einstellung deaktiviert und es wird kein Zeitlimit angewendet.
Anzeigen | Definiert den Anzeigemodus für die TrainPatMaxRedLine Grafiküberlagerung auf dem Bild.
0 = Alle ausblenden (Standard) | Alle Grafiken werden nur angezeigt, wenn die Zelle mit der TrainPatMaxRedLine-Funktion in der Tabelle markiert ist.
1 = Nur Ergebnis-Grafik | Die trainierten Merkmale des Musters werden immer angezeigt.
2 = Eingabe- und Ergebnis-Grafik | Der Eingabebildbereich, der Ursprung des Musters und die trainierten Merkmale werden immer angezeigt.
3 = Alles anzeigen: Eingabe, Ergebnis und Trainingsbild | Der Eingabebildbereich, der Ursprung des Musters, die trainierten Merkmale und das Trainingsbild werden immer angezeigt.

## TrainPatMaxRedLine – Ausgaben

Rückgabewert | Eine Patterns-Datenstruktur mit einem trainierten Muster oder #ERR, wenn ein oder mehrere Eingabeparameter ungültig sind.
Ergebnisse | Wenn TrainPatMaxRedLine in eine Zelle eingefügt wird, wird in der benachbarten Zelle auf der rechten Seite automatisch der Status „Trainiert“ erscheinen. Wenn ein Muster nicht trainiert werden kann, wird #ERR eingefügt. Es werden automatisch Patterns Vision Data Access functions in die Tabelle eingefügt:
Label | Funktion | Beschreibung
--- | --- | ---
Trainiert | GetTrained(Muster) | Gibt 1 zurück, falls ein Muster erfolgreich trainiert wurde und 0, falls ein Muster nicht trainiert werden kann.