create_scattered_data_interpolator — Creates an interpolator for the interpolation of scattered data.
create_scattered_data_interpolator creates the interpolator ScatteredDataInterpolatorHandle for the interpolation of scattered data, given as data points in Rows and Columns with the corresponding measurement Values. With the parameter Method the algorithm is specified, which should be used for the interpolation with interpolate_scattered_data. So far, only the '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_image, create_scattered_data_interpolator also supports subpixel coordinates for Rows and Columns. After the creation, interpolate_scattered_data is called for the interpolation of the unknown values. By splitting up the creation (create_scattered_data_interpolator) and the evaluation (interpolate_scattered_data) 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 GenParamNames and GenParamValues:
The parameter 'alpha' is a smoothing factor. For 'alpha' = 0, all points passed in Rows, Columns, and Values are interpolated exactly. With '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' >= 0
Method for the interpolation
Default value: 'thin_plate_splines'
Suggested values: 'thin_plate_splines'
Row coordinates of the points used for the interpolation
Column coordinates of the points used for the interpolation
Values of the points used for the interpolation
Names of the generic parameters that can be adjusted
Default value: 
Suggested values: 'alpha'
Values of the generic parameters that can be adjusted
Default value: 
Suggested values: 0, 1.0, 10.0, 100.0
Handle of the scattered data interpolator
If the parameters are valid, the operator create_scattered_data_interpolator returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.