Operators |
interpolate_scattered_data_points_to_image — Creating an image from the interpolation of scattered data.
interpolate_scattered_data_points_to_image( : ImageInterpolated : Method, Rows, Columns, Values, Width, Height, GenParamName, GenParamValue : )
interpolate_scattered_data_points_to_image interpolates the data points, given in Rows and Columns with the corresponding measurement Values, and returns the result in ImageInterpolated. The size of the output image is defined by its Width and its Height with the upper left corner at (0,0). In order to interpolate at negative coordinates of (Rows,Columns), simply translate all input points accordingly. With the parameter Method the interpolation algorithm is specified. 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 where r defines the distance of two points. In comparison to interpolate_scattered_data_image, interpolate_scattered_data_points_to_image also supports subpixel coordinates for Rows and Columns. If the same data points (Rows,Columns,Values) are used for the interpolation of different output images in subsequent steps, the operator create_scattered_data_interpolator may be more efficient.
The following parameters can be adjusted with GenParamName and GenParamValue:
The parameter 'alpha' is a smoothing factor. For 'alpha' = 0, all points passed in (Rows,Columns,Values) are interpolated exactly. With 'alpha' getting larger, the interpolation smoothes the points in way that all interpolated points of the result image ImageInterpolated lie on a common plane. Default value is 0. Restrictions: 'alpha' >= 0
Interpolated image
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
If the parameters are valid, the operator interpolate_scattered_data_points_to_image returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.
interpolate_scattered_data_image
Foundation
Operators |