HALCON Website / HALCON Operator Reference / Tools / Interpolation
ClassesClassesClassesClasses | | | | Operators

create_scattered_data_interpolatorT_create_scattered_data_interpolatorCreateScatteredDataInterpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolator (Operator)

Name

create_scattered_data_interpolatorT_create_scattered_data_interpolatorCreateScatteredDataInterpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolator — Creates an interpolator for the interpolation of scattered data.

Signature

create_scattered_data_interpolator( : : Method, Rows, Columns, Values, GenParamNames, GenParamValues : ScatteredDataInterpolatorHandle)

Herror T_create_scattered_data_interpolator(const Htuple Method, const Htuple Rows, const Htuple Columns, const Htuple Values, const Htuple GenParamNames, const Htuple GenParamValues, Htuple* ScatteredDataInterpolatorHandle)

Herror create_scattered_data_interpolator(const HTuple& Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& GenParamNames, const HTuple& GenParamValues, Hlong* ScatteredDataInterpolatorHandle)

void HScatteredDataInterpolator::CreateScatteredDataInterpolator(const HTuple& Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& GenParamNames, const HTuple& GenParamValues)

void CreateScatteredDataInterpolator(const HTuple& Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& GenParamNames, const HTuple& GenParamValues, HTuple* ScatteredDataInterpolatorHandle)

void HScatteredDataInterpolator::HScatteredDataInterpolator(const HString& Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& GenParamNames, const HTuple& GenParamValues)

void HScatteredDataInterpolator::HScatteredDataInterpolator(const char* Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& GenParamNames, const HTuple& GenParamValues)

void HScatteredDataInterpolator::CreateScatteredDataInterpolator(const HString& Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& GenParamNames, const HTuple& GenParamValues)

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

void HOperatorSetX.CreateScatteredDataInterpolator(
[in] VARIANT Method, [in] VARIANT Rows, [in] VARIANT Columns, [in] VARIANT Values, [in] VARIANT GenParamNames, [in] VARIANT GenParamValues, [out] VARIANT* ScatteredDataInterpolatorHandle)

void HScatteredDataInterpolatorX.CreateScatteredDataInterpolator(
[in] BSTR Method, [in] VARIANT Rows, [in] VARIANT Columns, [in] VARIANT Values, [in] VARIANT GenParamNames, [in] VARIANT GenParamValues)

static void HOperatorSet.CreateScatteredDataInterpolator(HTuple method, HTuple rows, HTuple columns, HTuple values, HTuple genParamNames, HTuple genParamValues, out HTuple scatteredDataInterpolatorHandle)

public HScatteredDataInterpolator(string method, HTuple rows, HTuple columns, HTuple values, HTuple genParamNames, HTuple genParamValues)

void HScatteredDataInterpolator.CreateScatteredDataInterpolator(string method, HTuple rows, HTuple columns, HTuple values, HTuple genParamNames, HTuple genParamValues)

Description

create_scattered_data_interpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolator creates the interpolator ScatteredDataInterpolatorHandleScatteredDataInterpolatorHandleScatteredDataInterpolatorHandleScatteredDataInterpolatorHandleScatteredDataInterpolatorHandlescatteredDataInterpolatorHandle for the interpolation of scattered data, given as data points in RowsRowsRowsRowsRowsrows and ColumnsColumnsColumnsColumnsColumnscolumns with the corresponding measurement ValuesValuesValuesValuesValuesvalues. With the parameter MethodMethodMethodMethodMethodmethod the algorithm is specified, which should be used for the interpolation with interpolate_scattered_datainterpolate_scattered_dataInterpolateScatteredDatainterpolate_scattered_dataInterpolateScatteredDataInterpolateScatteredData. So far, only the 'thin_plate_splines'"thin_plate_splines""thin_plate_splines""thin_plate_splines""thin_plate_splines""thin_plate_splines" are supported. This method interpolates on a global scale, which means that all points are regarded for the interpolation, no matter how far away they are. The influence of far points is correlated to r^2*log(r) where r defines the distance of two points. In comparison to interpolate_scattered_data_imageinterpolate_scattered_data_imageInterpolateScatteredDataImageinterpolate_scattered_data_imageInterpolateScatteredDataImageInterpolateScatteredDataImage, create_scattered_data_interpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolator also supports subpixel coordinates for RowsRowsRowsRowsRowsrows and ColumnsColumnsColumnsColumnsColumnscolumns. After the creation, interpolate_scattered_datainterpolate_scattered_dataInterpolateScatteredDatainterpolate_scattered_dataInterpolateScatteredDataInterpolateScatteredData is called for the interpolation of the unknown values. By splitting up the creation (create_scattered_data_interpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolator) and the evaluation (interpolate_scattered_datainterpolate_scattered_dataInterpolateScatteredDatainterpolate_scattered_dataInterpolateScatteredDataInterpolateScatteredData) of the interpolator, interpolating at different data points in subsequent steps becomes more efficient since the interpolator has to be created only once.

The following parameters can be adjusted with GenParamNamesGenParamNamesGenParamNamesGenParamNamesGenParamNamesgenParamNames and GenParamValuesGenParamValuesGenParamValuesGenParamValuesGenParamValuesgenParamValues:

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

The parameter 'alpha'"alpha""alpha""alpha""alpha""alpha" is a smoothing factor. For 'alpha'"alpha""alpha""alpha""alpha""alpha" = 0, all points passed in RowsRowsRowsRowsRowsrows, ColumnsColumnsColumnsColumnsColumnscolumns, and ValuesValuesValuesValuesValuesvalues are interpolated exactly. With 'alpha'"alpha""alpha""alpha""alpha""alpha" getting larger, the interpolation smoothes the points in way that all interpolated points lie on a common plane. Default value is 0. Restrictions: 'alpha'"alpha""alpha""alpha""alpha""alpha" >= 0

Parallelization

Parameters

MethodMethodMethodMethodMethodmethod (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Method for the interpolation

Default value: 'thin_plate_splines' "thin_plate_splines" "thin_plate_splines" "thin_plate_splines" "thin_plate_splines" "thin_plate_splines"

Suggested values: 'thin_plate_splines'"thin_plate_splines""thin_plate_splines""thin_plate_splines""thin_plate_splines""thin_plate_splines"

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

Row coordinates of the points used for the interpolation

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

Column coordinates of the points used for the interpolation

ValuesValuesValuesValuesValuesvalues (input_control)  number-array → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Values of the points used for the interpolation

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

Names of the generic parameters that can be adjusted

Default value: []

Suggested values: 'alpha'"alpha""alpha""alpha""alpha""alpha"

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

Values of the generic parameters that can be adjusted

Default value: []

Suggested values: 0, 1.0, 10.0, 100.0

ScatteredDataInterpolatorHandleScatteredDataInterpolatorHandleScatteredDataInterpolatorHandleScatteredDataInterpolatorHandleScatteredDataInterpolatorHandlescatteredDataInterpolatorHandle (output_control)  scattered_data_interpolator → HScatteredDataInterpolator, HTupleHTupleHScatteredDataInterpolator, HTupleHScatteredDataInterpolatorX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the scattered data interpolator

Result

If the parameters are valid, the operator create_scattered_data_interpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolator returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Successors

interpolate_scattered_datainterpolate_scattered_dataInterpolateScatteredDatainterpolate_scattered_dataInterpolateScatteredDataInterpolateScatteredData

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 11.0.5 Copyright © 1996-2015 MVTec Software GmbH