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.
Das Konzept der 2D-Messtechnik ist bei der Einleitung zu Kapitel 2D-Messtechnik beschrieben.
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
Kalibrierung 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 |
um, microns | 1e6 |
Wertevorschläge: 1.0, 0.1, 'm' , 'cm' , 'mm' , 'microns' , 'um'
Defaultwert: 1.0
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
MetrologyHandle
(input_control, Zustand wird modifiziert) metrology_model →
(handle)
Handle des Messmodells.
GenParamName
(input_control) attribute.name →
(string)
Name des generischen Parameter.
Defaultwert: 'camera_param'
Werteliste: 'camera_param' , 'plane_pose' , 'reference_system' , 'scale'
GenParamValue
(input_control) attribute.value(-array) →
(string / real / integer)
Wert des generischen Parameter.
Defaultwert: []
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