Globale Kalibrierungen¶
Übersicht¶
In Viper.NET können Kalibrierungen global angelegt und über einen eindeutigen Namen referenziert und verwendet werden. Über Gefasoft-Menü -> Functions -> Edit Calibration gelangt man zur Übersicht der Kalibrierungen:
Auf der linken Seite (1) befindet sich die Übersicht aller angelegter Kalibrierungen, Details und Parameter auf der rechten Seite (2). Die Details unterscheiden sich dabei je nach Kalibrierungstyp.
Neue Kalibrierschlüssel können über (+) und (-) hinzugefügt bzw. entfernt werden.
Warnung
Jede Kalibrierung in Viper.NET wird nur einmal geladen und bei Verwendung in Jobs oder ToolGroup-Items direkt zugewiesen. Das bedeutet, das Änderungen an der Kalibrierung innerhalb des Jobs direkt auf die globale Kalibrierung und somit auch auf alle anderen Jobs wirken, in denen diese Kalibrierung verwendet wird. Ausnahme: Bei SimpleFixture werden die Werte zugewiesen. Änderungen innerhalb des Jobs wirken sich somit nicht auf die globale Kalibrierung aus.
Derzeit werden folgende Typen unterstützt:
SimpleFixture
Kalibrierschlüssel ist veraltet: Verwendung von CogFixture empfohlen!
Entspricht dem Typ CogFixture, allerdings werden hier die Werte verwendet und keine gespeicherte Kalibrierung.
Die Parameter können hier direkt editiert werden. Über „Translation“ (3) kann eine Referenzposition im Bild gesetzt werden und über „Scaling“ (3) ein Skalierungswert berechnet werden. Diese Funktionen dienen zur Hilfe. Einzelne Parameter zu Kalibrierungen sollten jedoch automatisiert im Programm berechnet und gesetzt werden.
CogFixture
Zur Verwendung mit einem CogFixtureTool, siehe Cognex VisionPro Dokumentation.
CogFixtureNPointToNPoint
Zur Verwendung mit einem CogFixtureNPointToNPoint, siehe Cognex VisionPro Dokumentation.
CogCalibNPointToNPoint
Zur Verwendung mit einem CogCalibNPointToNPoint, siehe Cognex VisionPro Dokumentation.
CogCalibCheckerboard
Zur Verwendung mit einem CogCalibCheckerboard, siehe Cognex VisionPro Dokumentation.
Die eigentlichen Kalibrierdaten werden im Applikationsordner im Unterordner Data\Calib als .dat Dateien gespeichert.
Hinweis
Bei den Parametern für die Kalibrierungen auf die Vergabe eindeutiger Dateinamen achten.
Verwendung der globalen Kalibrierungen¶
Verknüpfen¶
Um eine Kalibrierung anzuwenden muss zuerst ein passendes Tool in den ToolgroupItem-Ablauf eingefügt werden.
Anschließend muss das neue Tool mit der globalen Kalibrierung verknüpft werden. Im Toolgroup Item Editor unter Bildquellen befindet sich dazu der Bereich „Calibration Assignment“ (1). Hier kann dem Tool die vorher definierte globale Kalibrierung zugeordnet werden.
Zuweisen¶
Die Zuweisung der Kalibrierung, also das Setzen der Werte im Kalibrier-Tool, erfolgt bei jeder Ausführung des Jobs. Dabei gilt:
Neu angelegte globale Kalibrierungen sind „leer“. In diesem Fall werden die Werte bzw. die RunParams aus dem Tool als globale Kalibrierung übernommen.
Ansonsten werden dem Tool die Werte bzw. RunParams der globalen Kalibrierung zugewiesen.
Hinweis
Nach dem Anlegen und Verknüpfen eines Kalibrier-Tools muss der Job einmal ausgeführt werden, um die Kalibrierung im Tool zu setzen. Dabei muss der komplette Job ausgeführt werden und nicht nur das einzelne Tool.
Hinweis
Eine geeignete Namensgebung von Kalibrierschlüssel und Kalibriertools ist sinnvoll. Werden mehrere Kalibriertools des gleichen Typs verwendet, so müssen diese intern eindeutig benannt werden, da in VisionPro angelegte Kalibrier-Objekte sonst überschrieben werden.
Hinweis
„Calibration ToolgroupItem“ zur automatisierten Berechnung einer Kalibrierung¶
Ein „Calibration ToolgroupItem“ wird benötigt um eine neue Kalibrierung zu berechnen und mit der globalen Kalibrierung zu vergleichen oder diese zu überschreiben. Dies wird je nach Anwendungszweck einmalig zur Inbetriebnahme oder in regelmäßigen Abständen ausgeführt.
Beim Anlegen eines ToolgroupItems muss dazu als Typ „Calibration“ ausgewählt werden:
Im Job-Editor werden Default-ToolgroupItems und Calibration-ToolgroupItems angezeigt:
Wie bei einem Default-ToolgroupItem müssen die entsprechenden Kalibriertools in den Bildverarbeitungsjob eingefügt werden.
Im Toolgroup Item Editor unter Erweiterungen (1) können die Kalibrierschlüssel mit den VisioPro-Tools verknüpft werden (2). Gleichzeitig gibt es die Möglichkeit einen User-Dialog(4) zu erstellen, der dem Benutzer einen Einblick in den Kalibrierstatus gibt und eine Bestätigung des Nutzers erwartet. Hierzu können Elemente der Auswahl Calibration (5) auf den Dialog in der Mitte „gedroppt“ werden. Mit „Accept/Reject“ können Buttons hinzugefügt werden um die Kalibrierung zu akzeptieren/verwerfen und somit eine Rückmeldung an die übergeordnete Steuerung zu geben. Soll eine Kalibrierung gespeichert werden, so muss dies mit dem Button „Apply new calibration“ durchgeführt werden. Auf der rechten Seite(6) sind weitere Einstellungen zur Anzeige des Kalibrierdialogs, wie z.B. der Textinhalt.
Warnung
Wenn eine Kalibrierung über das Calibration-ToolgroupItem geprüft bzw. verändert werden soll, muss diese zwingend über Erweiterungen zugewiesen werden und nicht über Zuordnung von Kalibrierungen. Ansonsten werden Änderungen an Kalibrierungen ohne Prüfung übernommen!
Das Aktivieren von „Auto-accept if job result is „Pass““(3) verhindert das Offnen des Kalibrierdialogs und akzeptiert automatisch (kein Überschreiben) die neue Kalibrierung. Ansonsten öffnet sich der Kalibrierdialog mit der vorkonfigurierten Anzeige und dem Kalibrierergebnis.
