| Operatoren |
set_metrology_model_param — Setzen von Parametern, die für das gesamte Messmodell gelten.
set_metrology_model_param( : : MetrologyHandle, GenParamName, GenParamValue : )
set_metrology_model_param setzt Parameter des Messmodells MetrologyHandle, die für das gesamte Modell, d.h. für alle Objekte, gültig sind (siehe create_metrology_model für das Grundprinzip der 2D-Messtechnik).
Die folgenden Werte können für GenParamName und GenParamValue gesetzt werden:
Um mit apply_metrology_model kalibrierte Messungen in metrischen Koordinaten durchführen zu können, müssen sowohl die Werte der internen Kameraparameter als auch die 3D-Lage der Messebene gesetzt werden.
In vielen Fällen sind die internen Kameraparameter das Ergebnis einer vorherigen Kamerakalibrierung mit dem Operator calibrate_cameras (siehe write_cam_par für die Reihenfolge der internen Kameraparameter und das zu Grunde liegende Kameramodell). Falls 'camera_param' auf [] gesetzt wird, werden die Werte der internen Kameraparameter gelöscht.
Default value: [].
Die 3D-Lage der Messebene in Kamerakoordinaten. Falls 'plane_pose' auf [] gesetzt wird, wird die Messebene gelöscht.
Default value: [].
Wenn Metrology-Messobjekte z.B. mit add_metrology_object_generic, add_metrology_object_circle_measure etc. zum Messmodell hinzugefügt werden, werden Positionen und Orientierungen bzgl. des Bildkoordinatensystems angegeben, welches seinen Ursprung in der linken oberen Bildecke hat. In manchen Fällen ist es nötig, das Referenzsystem bzgl. dem die Metrology-Messobjekte angegeben sind zu ändern. Dies ist z.B. der Fall, wenn ein Formmodell genutzt wird um das Messmodell im aktuellen Bild auszurichten. Die Ergebnisse von find_shape_model können nur direkt in align_metrology_model genutzt werden, wenn das Referenzsystem, in dem das Messmodel gegeben ist, mit dem Referenzsystems des Formmodells übereinstimmt (siehe align_metrology_model für ausführlichere Informationen)
Das in GenParamValue angegebene Tupel hat die Form [row, column, angle]. Per default ist das Referenzsystem das Bildkoordinatensystem, das sich in der linken oberen Ecke des Bildes befindet. Wird das Referenzkoordinatensystem neu gesetzt, so gibt das Tupel [row, column, angle] die Translation und Rotation des neuen Referenzkoordinatensystems bezüglich des Bildkoordinatensystems an. Alle Bestandteile (Objekte) des Messmodells werden in das neu gesetzte Koordinatensystem umgerechnet. Im folgenden Bild wird eine neues Referenzsystem auf den Mittelpunkt des Bildes gesetzt.
set_metrology_model_param (MetrologyHandle, 'reference_system', [Height/2,Width/2,0])
| (1) | (2) |
Default value: [0, 0, 0]
Die Ergebnisse der Messung, die mit get_metrology_object_result abgerufen werden, können mit einem Faktor skaliert werden.
Der Parameter legt die Skalierung oder die Einheit der Ergebnisse der Messungen fest. Der Parameter 'scale' entspricht dem Verhältnis der gewünschten Einheit zur ursprünglichen Einheit.
Sind keine Kameraparameter gegeben, so ist die Standardeinheit Pixel.
Wurden 'camera_param' and 'plane_pose' gesetzt, so wird die Einheit durch die Koordinaten des Kalibrierungobjektes bestimmt. Die standard HALCON Kalibrierplatte ist in metrischen Koordinaten definiert. Wird sie für die Kalibrierung verwendet, kann die gewünschte Einheit direkt gesetzt werden. Die Zuordnung von Einheiten zu Faktoren ergibt sich aus der folgenden Tabelle:
| Einheit | Skalierungsfaktor |
|---|---|
| m | 1 |
| dm | 10 |
| cm | 100 |
| mm | 1000 |
| µm, microns | 1e6 |
Wertevorschläge: 1.0, 0.1, 'm', 'cm', 'mm', 'microns', 'um'
Defaultwert: 1.0
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Der Wert dieses Parameters darf nicht über mehrere Threads verwendet werden.Handle des Messmodells.
Name des generischen Parameter.
Defaultwert: 'camera_param'
Werteliste: 'camera_param', 'plane_pose', 'reference_system', 'scale'
Wert des generischen Parameter.
Defaultwert: [0,0,0,0,0,0,0,0]
Wertevorschläge: 1.0, 0.1, 'm', 'cm', 'mm', 'microns', 'um'
Sind die Parameterwerte korrekt, dann liefert set_metrology_model_param den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
create_metrology_model, set_metrology_model_image_size
add_metrology_object_generic, get_metrology_object_model_contour
set_metrology_object_param, align_metrology_model, get_metrology_model_param
2D Metrology
| Operatoren |