HALCON Website / HALCON Operator-Referenz / 2D-Messtechnik
KlassenKlassenKlassenKlassen | | | | Operatoren

get_metrology_object_resultget_metrology_object_resultGetMetrologyObjectResultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResult (Operator)

Name

get_metrology_object_resultget_metrology_object_resultGetMetrologyObjectResultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResult — Abfragen der Ergebnisse der Anpassung des Messmodells.

Signatur

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

Herror get_metrology_object_result(const Hlong MetrologyHandle, const Hlong Indices, const Hlong Instance, const char* GenParamName, const char* GenParamValue, double* Parameter)

Herror T_get_metrology_object_result(const Htuple MetrologyHandle, const Htuple Indices, const Htuple Instance, const Htuple GenParamName, const Htuple GenParamValue, Htuple* Parameter)

Herror get_metrology_object_result(const HTuple& MetrologyHandle, const HTuple& Indices, const HTuple& Instance, const HTuple& GenParamName, const HTuple& GenParamValue, double* Parameter)

Herror get_metrology_object_result(const HTuple& MetrologyHandle, const HTuple& Indices, const HTuple& Instance, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* Parameter)

HTuple HMetrologyModel::GetMetrologyObjectResult(const HTuple& Indices, const HTuple& Instance, const HTuple& GenParamName, const HTuple& GenParamValue) const

void GetMetrologyObjectResult(const HTuple& MetrologyHandle, const HTuple& Indices, const HTuple& Instance, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* Parameter)

HTuple HMetrologyModel::GetMetrologyObjectResult(const HTuple& Indices, const HTuple& Instance, const HTuple& GenParamName, const HTuple& GenParamValue) const

HTuple HMetrologyModel::GetMetrologyObjectResult(Hlong Indices, Hlong Instance, const HString& GenParamName, const HString& GenParamValue) const

HTuple HMetrologyModel::GetMetrologyObjectResult(Hlong Indices, Hlong Instance, const char* GenParamName, const char* GenParamValue) const

void HOperatorSetX.GetMetrologyObjectResult(
[in] VARIANT MetrologyHandle, [in] VARIANT Indices, [in] VARIANT Instance, [in] VARIANT GenParamName, [in] VARIANT GenParamValue, [out] VARIANT* Parameter)

VARIANT HMetrologyModelX.GetMetrologyObjectResult(
[in] VARIANT Indices, [in] VARIANT Instance, [in] VARIANT GenParamName, [in] VARIANT GenParamValue)

static void HOperatorSet.GetMetrologyObjectResult(HTuple metrologyHandle, HTuple indices, HTuple instance, HTuple genParamName, HTuple genParamValue, out HTuple parameter)

HTuple HMetrologyModel.GetMetrologyObjectResult(HTuple indices, HTuple instance, HTuple genParamName, HTuple genParamValue)

HTuple HMetrologyModel.GetMetrologyObjectResult(int indices, int instance, string genParamName, string genParamValue)

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 (siehe create_metrology_modelcreate_metrology_modelCreateMetrologyModelcreate_metrology_modelCreateMetrologyModelCreateMetrologyModel für das Grundprinzip der 2D-Messtechnik). Das Messmodell ist durch das Handle MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle definiert. Der Parameter IndicesIndicesIndicesIndicesIndicesindices legt fest für welche Metrology-Messobjekte die Ergebnisse abgefragt werden sollen. Wird für den Parameter IndicesIndicesIndicesIndicesIndicesindices 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":

Der Parameter legt den Typ des Rückgabewertes fest. Wird der Parameter 'result_type'"result_type""result_type""result_type""result_type""result_type" auf 'param'"param""param""param""param""param" gesetzt, wird das Messergebnis der Metrology-Messobjekte zurückgegeben (generiert vom Operator apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel). Wenn der Typ des Metrology-Messobjekts ein 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"]. Wenn der Objekttyp 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"]. Wenn der Typ des Metrology-Messobjekts eine Linie ist, sind die Rückgabewerte die 3 Parameter der Hesseschen Normalform, d.h. der (Zeilen-, Spalten-) Einheitsnormalenvektor [row, column] und der orthogonale Abstand [d] der Linie vom Ursprung des Koordinatensystems. Die Reihenfolge ist [row, column, d]. Das Vorzeichen des Abstands legt die Seite der Linie fest, auf welcher sich der Ursprung befindet. Wenn der Typ des Metrology-Messobjekts 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"].

Wird der Parameter 'result_type'"result_type""result_type""result_type""result_type""result_type" 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.

Wertevorschläge: 'param'"param""param""param""param""param", 'score'"score""score""score""score""score"

Defaultwert: 'param'"param""param""param""param""param"

'scale'"scale""scale""scale""scale""scale":

Der Parameter legt die Skalierung oder die Einheit der Ergebnisse der Messungen fest. Der Parameter 'scale'"scale""scale""scale""scale""scale" entspricht dem Verhältnis der gewünschten Einheit zur ursprünglichen Einheit. Wird für den Parameter 'scale'"scale""scale""scale""scale""scale" ein Float-Wert gesetzt, wird das Ergebnis mit diesem Float-Wert scaliert. Für unkalibrierte Metrology-Messobjekte ist die ursprüngliche Einheit ein Pixel. Für kalibrierte Metrology-Messobjekte (siehe auch Parameter 'camera_param'"camera_param""camera_param""camera_param""camera_param""camera_param" und 'world_pose'"world_pose""world_pose""world_pose""world_pose""world_pose" des Operators set_metrology_object_paramset_metrology_object_paramSetMetrologyObjectParamset_metrology_object_paramSetMetrologyObjectParamSetMetrologyObjectParam), ist die ursprüngliche Einheit durch die Koordinaten des Kalibrierkörpers gegeben. Falls diese, wie bei einer der Standard-Kalibrierplatten, im metrischen System gegeben sind, ist es auch möglich, die gewünschte Einheit direkt durch 'm'"m""m""m""m""m", 'cm'"cm""cm""cm""cm""cm", 'mm'"mm""mm""mm""mm""mm", 'microns'"microns""microns""microns""microns""microns" oder 'um'"um""um""um""um""um" anzugeben.

Wertevorschläge: 1.0, 0.1, 'm'"m""m""m""m""m", 'cm'"cm""cm""cm""cm""cm", 'mm'"mm""mm""mm""mm""mm", 'microns'"microns""microns""microns""microns""microns", 'um'"um""um""um""um""um"

Defaultwert: 1.0

'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 IndicesIndicesIndicesIndicesIndicesindices) 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.

Achtung

Ein Messmodell 'MetrologyHandle'"MetrologyHandle""MetrologyHandle""MetrologyHandle""MetrologyHandle""MetrologyHandle" kann nur von einem Thread aus verwendet werden. Verschiedene Messmodelle können dagegen in unterschiedlichen Threads genutzt werden.

Parallelisierung

Parameter

MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (input_control)  metrology_model → HMetrologyModel, HTupleHTupleHMetrologyModel, HTupleHMetrologyModelX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle des Messmodells.

IndicesIndicesIndicesIndicesIndicesindices (input_control)  integer(-array) → HTupleHTupleHTupleVARIANTHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*) (Hlong / BSTR) (Hlong / char*)

Indizes der Metrology-Messobjekte.

Defaultwert: 0

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

InstanceInstanceInstanceInstanceInstanceinstance (input_control)  integer(-array) → HTupleHTupleHTupleVARIANTHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*) (Hlong / BSTR) (Hlong / char*)

Instanzen der Metrology-Messobjekte

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

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

GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  attribute.name(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Namen der generischen Parameter.

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", 'scale'"scale""scale""scale""scale""scale"

GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control)  attribute.value(-array) → HTupleHTupleHTupleVARIANTHtuple (string / real) (string / double) (HString / double) (char* / double) (BSTR / double) (char* / double)

Werte der generischen Parameter.

Defaultwert: 'param' "param" "param" "param" "param" "param"

Wertevorschläge: 'param'"param""param""param""param""param", 'score'"score""score""score""score""score", 1.0, 0.1, 'm'"m""m""m""m""m", 'mm'"mm""mm""mm""mm""mm", 'microns'"microns""microns""microns""microns""microns", 'um'"um""um""um""um""um", 'true'"true""true""true""true""true", 'false'"false""false""false""false""false"

ParameterParameterParameterParameterParameterparameter (output_control)  real(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*) (double / Hlong / BSTR) (double / Hlong / char*)

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.

Vorgänger

apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel

Nachfolger

clear_metrology_modelclear_metrology_modelClearMetrologyModelclear_metrology_modelClearMetrologyModelClearMetrologyModel

Modul

2D Metrology

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 11.0.5 Copyright © 1996-2015 MVTec Software GmbH