get_metrology_object_resultT_get_metrology_object_resultGetMetrologyObjectResultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResult (Operator)

Name

get_metrology_object_resultT_get_metrology_object_resultGetMetrologyObjectResultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResult — Abfragen der Ergebnisse der Anpassung des Messmodells.

Signatur

get_metrology_object_result( : : MetrologyHandle, Index, Instance, GenParamName, GenParamValue : Parameter)

Beschreibung

get_metrology_object_resultget_metrology_object_resultGetMetrologyObjectResultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResult erlaubt den Zugriff auf die Ergebnisse der Messungen der Metrology-Messobjekte, die von apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel berechnet wurden.

Das Konzept der 2D-Messtechnik ist bei der Einleitung zu Kapitel 2D-Messtechnik beschrieben.

Das Messmodell ist durch das Handle MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle definiert. Der Parameter IndexIndexIndexIndexIndexindex legt fest für welche Metrology-Messobjekte die Ergebnisse abgefragt werden sollen. Wird für den Parameter IndexIndexIndexIndexIndexindex als Wert 'all'"all""all""all""all""all" übergeben, werden die Ergebnisse aller Metrology-Messobjekte abgefragt. Mit dem Parameter InstanceInstanceInstanceInstanceInstanceinstance wird angegeben, welche Instanz der Ergebnisse in ParameterParameterParameterParameterParameterparameter zurückgegeben wird. Wird InstanceInstanceInstanceInstanceInstanceinstance auf 'all'"all""all""all""all""all" gesetzt, werden alle Instanzen zurückgegeben. Es können verschiedene generische Parameter angegeben werden, mit denen die Rückgabewerte in ParameterParameterParameterParameterParameterparameter gesteuert werden können. Die generischen Parameternamen werden in GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName gesetzt. Die dazugehörigen Werte werden im Parameter GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue übergeben.

Folgende Parameter und Werte sind möglich:

'result_type'"result_type""result_type""result_type""result_type""result_type":

Setzt man GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName auf 'result_type'"result_type""result_type""result_type""result_type""result_type" kann mittels GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName bestimmt werden, wie und welche Resultate für ein Metrology-Messobjekt ausgegeben werden. Alle für ein Metrology-Messobjekt gemessenen Parameter können auf einmal abgerufen werden. Weiterhin können spezielle Parameter oder der Score abgerufen werden.

Abfragen aller Parameter:

Wenn GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue auf 'all_param'"all_param""all_param""all_param""all_param""all_param" gesetzt wurde, dann werden alle für ein Metrology-Messobjekt gemessenen Parameter zurückgegeben. Wurden Kameraparameter und eine Messebene gesetzt (siehe set_metrology_model_paramset_metrology_model_paramSetMetrologyModelParamset_metrology_model_paramSetMetrologyModelParamSetMetrologyModelParam), so werden die Ergebnisse in metrischen Koordinaten zurückgegeben, andernfalls in Pixeln.

Für einen Kreis ist, werden die Mittelpunktskoordinaten (Zeile 'row'"row""row""row""row""row" und Spalte 'column'"column""column""column""column""column") sowie der Radius 'radius'"radius""radius""radius""radius""radius" des Kreises zurückgegeben. Die Reihenfolge ist ['row'"row""row""row""row""row", 'column'"column""column""column""column""column", 'radius'"radius""radius""radius""radius""radius"] oder ['x'"x""x""x""x""x", 'y'"y""y""y""y""y", 'radius'"radius""radius""radius""radius""radius"].

Für eine Ellipse ist, werden die Mittelpunktskoordinaten (Zeile 'row'"row""row""row""row""row" und Spalte 'column'"column""column""column""column""column"), die Orientierung der Hauptachse 'phi'"phi""phi""phi""phi""phi", die Länge der großen Halbachse 'radius1'"radius1""radius1""radius1""radius1""radius1" sowie die Länge der kleinen Halbachse 'radius2'"radius2""radius2""radius2""radius2""radius2" der Ellipse zurückgegeben. Die Reihenfolge ist ['row'"row""row""row""row""row", 'column'"column""column""column""column""column", 'phi'"phi""phi""phi""phi""phi", 'radius1'"radius1""radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2""radius2"] oder ['x'"x""x""x""x""x", 'y'"y""y""y""y""y", 'phi'"phi""phi""phi""phi""phi", 'radius1'"radius1""radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2""radius2"].

Für eine Linie ist, wird der Start- und Endpunkt der Linie zurückgegeben Die Reihenfolge ist ['row_begin'"row_begin""row_begin""row_begin""row_begin""row_begin", 'column_begin'"column_begin""column_begin""column_begin""column_begin""column_begin", 'row_end'"row_end""row_end""row_end""row_end""row_end", 'column_end'"column_end""column_end""column_end""column_end""column_end"] oder ['x_begin'"x_begin""x_begin""x_begin""x_begin""x_begin", 'y_begin'"y_begin""y_begin""y_begin""y_begin""y_begin", 'x_end'"x_end""x_end""x_end""x_end""x_end", 'y_end'"y_end""y_end""y_end""y_end""y_end"].

Für ein Rechteck ist, werden die Mittelpunktskoordinaten (Zeile 'row'"row""row""row""row""row" und Spalte 'column'"column""column""column""column""column"), die Orientierung der Hauptachse 'phi'"phi""phi""phi""phi""phi", der erste Halbmesser (halbe Länge) 'length1'"length1""length1""length1""length1""length1" und der zweite Halbmesser (halbe Länge) 'length2'"length2""length2""length2""length2""length2" des Rechtecks zurückgegeben. Die Reihenfolge ist ['row'"row""row""row""row""row", 'column'"column""column""column""column""column",'phi'"phi""phi""phi""phi""phi",'length1'"length1""length1""length1""length1""length1", 'length2'"length2""length2""length2""length2""length2"] oder ['x'"x""x""x""x""x", 'y'"y""y""y""y""y",'phi'"phi""phi""phi""phi""phi",'length1'"length1""length1""length1""length1""length1", 'length2'"length2""length2""length2""length2""length2"].

Abfragen spezieller Parameter:

Gemessene Objektparameter können auch einzeln abgerufen werden, indem GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName auf den gewünschten Parameternamen gesetzt wird.

Wurden keine Kameraparameter und keine Messebene gesetzt, können die folgenden Parameter einzeln abgerufen werden, wenn sie für das jeweilige Metrology-Messobjekts verfügbar sind. Bitte beachten Sie, dass für Linien zusätzlich die drei Parameter der Hesse-Normalform abgefragt werden können, d.h. der Einheitsvektor der Normale 'nrow'"nrow""nrow""nrow""nrow""nrow", 'ncolumn'"ncolumn""ncolumn""ncolumn""ncolumn""ncolumn" und der orthogonale Abstand [distance] der Linie vom Ursprung des Koordinatensystems. Das Vorzeichen des Abstands legt die Seite der Linie fest, auf welcher sich der Ursprung befindet.

Wertevorschläge: 'row'"row""row""row""row""row", 'column'"column""column""column""column""column", 'radius'"radius""radius""radius""radius""radius", 'phi'"phi""phi""phi""phi""phi" , 'radius1'"radius1""radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2""radius2", 'length1'"length1""length1""length1""length1""length1", 'length2'"length2""length2""length2""length2""length2", 'row_begin'"row_begin""row_begin""row_begin""row_begin""row_begin", 'column_begin'"column_begin""column_begin""column_begin""column_begin""column_begin", 'row_end'"row_end""row_end""row_end""row_end""row_end", 'column_end'"column_end""column_end""column_end""column_end""column_end", 'nrow'"nrow""nrow""nrow""nrow""nrow", 'ncolumn'"ncolumn""ncolumn""ncolumn""ncolumn""ncolumn", 'distance'"distance""distance""distance""distance""distance"

Wurden Kameraparameter und eine Messebene gesetzt, können die folgenden metrischen Parameter einzeln abgerufen werden, wenn sie für das jeweilige Metrology-Messobjekts verfügbar sind. Bitte beachten Sie, dass für Linien zusätzlich die drei Parameter der Hesse-Normalform abgefragt werden können, d.h. der Einheitsvektor der Normale 'nx'"nx""nx""nx""nx""nx", 'ny'"ny""ny""ny""ny""ny" und der orthogonale Abstand [distance] der Linie vom Ursprung des Koordinatensystems. Das Vorzeichen des Abstands legt die Seite der Linie fest, auf welcher sich der Ursprung befindet.

Wertevorschläge: 'x'"x""x""x""x""x", 'y'"y""y""y""y""y", 'radius'"radius""radius""radius""radius""radius", 'phi'"phi""phi""phi""phi""phi" , 'radius1'"radius1""radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2""radius2", 'length1'"length1""length1""length1""length1""length1", 'length2'"length2""length2""length2""length2""length2", 'x_begin'"x_begin""x_begin""x_begin""x_begin""x_begin", 'y_begin'"y_begin""y_begin""y_begin""y_begin""y_begin", 'x_end'"x_end""x_end""x_end""x_end""x_end", 'y_end'"y_end""y_end""y_end""y_end""y_end", 'nx'"nx""nx""nx""nx""nx", 'ny'"ny""ny""ny""ny""ny", 'distance'"distance""distance""distance""distance""distance"

Abfragen des Scores:

Wird GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName auf den Wert 'score'"score""score""score""score""score" gesetzt, wird der Score der Ergebnisse zurückgegeben. Der Score ist die Anzahl der Messungen, die für die Berechnung des Ergebnisses verwendet werden dividiert durch die maximale Anzahl von Messregionen.

'used_edges'"used_edges""used_edges""used_edges""used_edges""used_edges":

Mit den folgenden Werten für GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue können Details zu den Kanten abgefragt werden, die für die Anpassung eines Metrology-Messobjekts verwendet wurden.

'row'"row""row""row""row""row":: Die Zeilenkoordinaten der Kanten, die für die Anpassung eines Metrology-Messobjektes verwendet wurden, werden zurückgegeben.
'column'"column""column""column""column""column":: Die Spaltenkoordinaten der Kanten, die für die Anpassung eines Metrology-Messobjektes verwendet wurden, werden zurückgegeben.
'amplitude'"amplitude""amplitude""amplitude""amplitude""amplitude":: Die Amplitude der Kanten, die für die Anpassung eines Metrology-Messobjektes verwendet wurden, werden zurückgegeben.

Wertevorschläge: 'row'"row""row""row""row""row", 'column'"column""column""column""column""column", 'amplitude'"amplitude""amplitude""amplitude""amplitude""amplitude"

'angle_direction'"angle_direction""angle_direction""angle_direction""angle_direction""angle_direction":

Der Parameter legt die Drehrichtung für Winkel fest, die Ergebnisse der Anpassung sind. Wird der Parameter 'angle_direction'"angle_direction""angle_direction""angle_direction""angle_direction""angle_direction" auf 'positive'"positive""positive""positive""positive""positive" gesetzt, ist der Winkel zwischen der Hauptachse des Objekts und der horizontalen Achse des Koordinatensystems im mathematisch positiven Sinn (gegen den Uhrzeigersinn) definiert. Wird der Parameter 'angle_direction'"angle_direction""angle_direction""angle_direction""angle_direction""angle_direction" auf 'negative'"negative""negative""negative""negative""negative" gesetzt, ist der Winkel zwischen der Hauptachse des Objekts und der horizontalen Achse des Koordinatensystems im mathematisch negativen Sinn (im Uhrzeigersinn) definiert. Die Winkelergebnisse werden im Bogenmaß ausgegeben.

Wertevorschläge: 'positive'"positive""positive""positive""positive""positive", 'negative'"negative""negative""negative""negative""negative"

Defaultwert: 'positive'"positive""positive""positive""positive""positive"

Es ist möglich die Ergebnisse mehrerer Metrology-Messobjekte (siehe Parameter IndexIndexIndexIndexIndexindex) und mehrerer Instanzen (siehe Parameter InstanceInstanceInstanceInstanceInstanceinstance) der Metrology-Messobjekte gleichzeitig zurückzugeben. Die Ergebnisse werden in ParameterParameterParameterParameterParameterparameter in der folgenden Reihenfolge zurückgegeben: 1. Instanz des 1. Metrology-Messobjekts, 2. Instanz des 1. Metrology-Messobjekts, usw., 1. Instanz des 2. Metrology-Messobjekts, 2. Instanz des 2. Metrology-Messobjekts, usw.

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (input_control) metrology_model → (integer)

Handle des Messmodells.

IndexIndexIndexIndexIndexindex (input_control) integer(-array) → (integer / string)

Index des Metrology-Messobjektes.

Defaultwert: 'all' "all" "all" "all" "all" "all"

Wertevorschläge: 'all'"all""all""all""all""all", 0, 1, 2

InstanceInstanceInstanceInstanceInstanceinstance (input_control) integer(-array) → (integer / string)

Instanz des Metrology-Messobjektes

Defaultwert: 'all' "all" "all" "all" "all" "all"

Wertevorschläge: 'all'"all""all""all""all""all", 0, 1, 2

GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control) attribute.name-array → (string)

Name des generischen Parameters.

Defaultwert: 'result_type' "result_type" "result_type" "result_type" "result_type" "result_type"

Werteliste: 'angle_direction'"angle_direction""angle_direction""angle_direction""angle_direction""angle_direction", 'result_type'"result_type""result_type""result_type""result_type""result_type", 'used_edges'"used_edges""used_edges""used_edges""used_edges""used_edges"

GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control) attribute.value-array → (string / real)

Wert des generischen Parameters.

Defaultwert: 'all_param' "all_param" "all_param" "all_param" "all_param" "all_param"

Wertevorschläge: 'all_param'"all_param""all_param""all_param""all_param""all_param", 'score'"score""score""score""score""score", 'true'"true""true""true""true""true", 'false'"false""false""false""false""false", 'row'"row""row""row""row""row", 'column'"column""column""column""column""column", 'amplitude'"amplitude""amplitude""amplitude""amplitude""amplitude", 'radius'"radius""radius""radius""radius""radius", 'phi'"phi""phi""phi""phi""phi", 'radius1'"radius1""radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2""radius2", 'length1'"length1""length1""length1""length1""length1", 'length2'"length2""length2""length2""length2""length2", 'row_begin'"row_begin""row_begin""row_begin""row_begin""row_begin", 'column_begin'"column_begin""column_begin""column_begin""column_begin""column_begin", 'row_end'"row_end""row_end""row_end""row_end""row_end", 'column_end'"column_end""column_end""column_end""column_end""column_end", 'nrow'"nrow""nrow""nrow""nrow""nrow", 'ncolumn'"ncolumn""ncolumn""ncolumn""ncolumn""ncolumn", 'distance'"distance""distance""distance""distance""distance", 'x'"x""x""x""x""x", 'y'"y""y""y""y""y", 'x_begin'"x_begin""x_begin""x_begin""x_begin""x_begin", 'y_begin'"y_begin""y_begin""y_begin""y_begin""y_begin", 'x_end'"x_end""x_end""x_end""x_end""x_end", 'y_end'"y_end""y_end""y_end""y_end""y_end", 'nx'"nx""nx""nx""nx""nx", 'ny'"ny""ny""ny""ny""ny", 'positive'"positive""positive""positive""positive""positive", 'negative'"negative""negative""negative""negative""negative"

ParameterParameterParameterParameterParameterparameter (output_control) real(-array) → (real / integer / string)

Ergebniswerte.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert get_metrology_object_resultget_metrology_object_resultGetMetrologyObjectResultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResult den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

get_metrology_object_result_contourget_metrology_object_result_contourGetMetrologyObjectResultContourget_metrology_object_result_contourGetMetrologyObjectResultContourGetMetrologyObjectResultContour, get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures

Modul

2D Metrology

Operatoren