HALCON Website / HALCON Operator-Referenz / Tools / Interpolation
KlassenKlassen | | Operatoren

create_scattered_data_interpolatorT_create_scattered_data_interpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolator (Operator)

Name

create_scattered_data_interpolatorT_create_scattered_data_interpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolator — Erzeugung eines Interpolators zur Interpolation von verstreuten Datenpunkten.

Signatur

create_scattered_data_interpolator( : : Method, Rows, Columns, Values, GenParamName, GenParamValue : ScatteredDataInterpolatorHandle)

Herror T_create_scattered_data_interpolator(const Htuple Method, const Htuple Rows, const Htuple Columns, const Htuple Values, const Htuple GenParamName, const Htuple GenParamValue, Htuple* ScatteredDataInterpolatorHandle)

void CreateScatteredDataInterpolator(const HTuple& Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* ScatteredDataInterpolatorHandle)

void HScatteredDataInterpolator::HScatteredDataInterpolator(const HString& Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& GenParamName, const HTuple& GenParamValue)

void HScatteredDataInterpolator::HScatteredDataInterpolator(const char* Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& GenParamName, const HTuple& GenParamValue)

void HScatteredDataInterpolator::HScatteredDataInterpolator(const wchar_t* Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& GenParamName, const HTuple& GenParamValue)   (Nur Windows)

void HScatteredDataInterpolator::CreateScatteredDataInterpolator(const HString& Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& GenParamName, const HTuple& GenParamValue)

void HScatteredDataInterpolator::CreateScatteredDataInterpolator(const char* Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& GenParamName, const HTuple& GenParamValue)

void HScatteredDataInterpolator::CreateScatteredDataInterpolator(const wchar_t* Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& GenParamName, const HTuple& GenParamValue)   (Nur Windows)

static void HOperatorSet.CreateScatteredDataInterpolator(HTuple method, HTuple rows, HTuple columns, HTuple values, HTuple genParamName, HTuple genParamValue, out HTuple scatteredDataInterpolatorHandle)

public HScatteredDataInterpolator(string method, HTuple rows, HTuple columns, HTuple values, HTuple genParamName, HTuple genParamValue)

void HScatteredDataInterpolator.CreateScatteredDataInterpolator(string method, HTuple rows, HTuple columns, HTuple values, HTuple genParamName, HTuple genParamValue)

Beschreibung

create_scattered_data_interpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolator erzeugt den Interpolator ScatteredDataInterpolatorHandleScatteredDataInterpolatorHandleScatteredDataInterpolatorHandleScatteredDataInterpolatorHandlescatteredDataInterpolatorHandle anhand der verstreuten Datenpunkte RowsRowsRowsRowsrows, ColumnsColumnsColumnsColumnscolumns und der dazugehörigen Messwerte ValuesValuesValuesValuesvalues für die Interpolation der Messwerte an unbekannten Datenpunkten. Mit dem Parameter MethodMethodMethodMethodmethod wird der Algorithmus festgelegt, der für die Interpolation mit interpolate_scattered_datainterpolate_scattered_dataInterpolateScatteredDataInterpolateScatteredDataInterpolateScatteredData verwendet werden soll. Bisher werden nur die 'thin_plate_splines'"thin_plate_splines""thin_plate_splines""thin_plate_splines""thin_plate_splines" unterstützt. Diese Methode interpoliert die Datenpunkte auf globaler Ebene, was bedeutet, dass alle Punkte für die Interpolation verwendet werden, egal wie weit sie von einander weg liegen. Der Einfluss von entfernten Punkten korreliert mit wobei r die Entfernung zweier Punkte beschreibt. Im Vergleich zu interpolate_scattered_data_imageinterpolate_scattered_data_imageInterpolateScatteredDataImageInterpolateScatteredDataImageInterpolateScatteredDataImage, unterstützt create_scattered_data_interpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolator auch subpixelgenaue Koordinaten für RowsRowsRowsRowsrows und ColumnsColumnsColumnsColumnscolumns. Nach der Erzeugung des Interpolators wird interpolate_scattered_datainterpolate_scattered_dataInterpolateScatteredDataInterpolateScatteredDataInterpolateScatteredData für die Interpolation der unbekannten Messwerte aufgerufen. Durch die Aufteilung der Erzeugung (create_scattered_data_interpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolator) und der Auswertung (interpolate_scattered_datainterpolate_scattered_dataInterpolateScatteredDataInterpolateScatteredDataInterpolateScatteredData) des Interpolators, wird die Interpolation an unterschiedlichen Datenpunkten in aufeinanderfolgenden Messungen effizienter, da der Interpolator nur einmal erzeugt werden muss.

Die folgenden Parameter können mit GenParamNameGenParamNameGenParamNameGenParamNamegenParamName und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue gesetzt werden:

'alpha'"alpha""alpha""alpha""alpha":

Der Parameter 'alpha'"alpha""alpha""alpha""alpha" ist ein Glättungsfaktor. Für 'alpha'"alpha""alpha""alpha""alpha" = 0 werden alle übergebenen Datenpunkte RowsRowsRowsRowsrows, ColumnsColumnsColumnsColumnscolumns mit ValuesValuesValuesValuesvalues exakt interpoliert. Für sehr große Werte von 'alpha'"alpha""alpha""alpha""alpha" glättet die Interpolation die Punkte so, dass alle interpolierten Punkte auf einer gemeinsamen Ebene liegen. Defaultwert ist 0. Beschränkungen: 'alpha'"alpha""alpha""alpha""alpha" >= 0

Ausführungsinformationen

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

MethodMethodMethodMethodmethod (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Methode für die Interpolation.

Defaultwert: 'thin_plate_splines' "thin_plate_splines" "thin_plate_splines" "thin_plate_splines" "thin_plate_splines"

Wertevorschläge: 'thin_plate_splines'"thin_plate_splines""thin_plate_splines""thin_plate_splines""thin_plate_splines"

RowsRowsRowsRowsrows (input_control)  point.y-array → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Zeilenkoordinaten der Stützstellen.

ColumnsColumnsColumnsColumnscolumns (input_control)  point.x-array → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Spaltenkoordinaten der Stützstellen.

ValuesValuesValuesValuesvalues (input_control)  number-array → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Messwerte an den Stützstellen.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  attribute.name-array → HTupleHTupleHtuple (string) (string) (HString) (char*)

Namen der generischen Parameter, die angepasst werden können.

Defaultwert: []

Wertevorschläge: 'alpha'"alpha""alpha""alpha""alpha"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control)  attribute.value-array → HTupleHTupleHtuple (real / string / integer) (double / string / int / long) (double / HString / Hlong) (double / char* / Hlong)

Werte der generischen Parameter, die angepasst werden können.

Defaultwert: []

Wertevorschläge: 0, 1.0, 10.0, 100.0

ScatteredDataInterpolatorHandleScatteredDataInterpolatorHandleScatteredDataInterpolatorHandleScatteredDataInterpolatorHandlescatteredDataInterpolatorHandle (output_control)  scattered_data_interpolator → HScatteredDataInterpolator, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle des Interpolators für verstreute Daten

Ergebnis

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

Nachfolger

interpolate_scattered_datainterpolate_scattered_dataInterpolateScatteredDataInterpolateScatteredDataInterpolateScatteredData

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 19.11.0.0 Copyright © 1996-2019 MVTec Software GmbH