ClassesClassesClassesClasses | | | | Operators

interpolate_scattered_data_points_to_imageT_interpolate_scattered_data_points_to_imageInterpolateScatteredDataPointsToImageinterpolate_scattered_data_points_to_imageInterpolateScatteredDataPointsToImageInterpolateScatteredDataPointsToImage (Operator)

Name

interpolate_scattered_data_points_to_imageT_interpolate_scattered_data_points_to_imageInterpolateScatteredDataPointsToImageinterpolate_scattered_data_points_to_imageInterpolateScatteredDataPointsToImageInterpolateScatteredDataPointsToImage — Creating an image from the interpolation of scattered data.

Signature

interpolate_scattered_data_points_to_image( : ImageInterpolated : Method, Rows, Columns, Values, Width, Height, GenParamNames, GenParamValues : )

Herror T_interpolate_scattered_data_points_to_image(Hobject* ImageInterpolated, const Htuple Method, const Htuple Rows, const Htuple Columns, const Htuple Values, const Htuple Width, const Htuple Height, const Htuple GenParamNames, const Htuple GenParamValues)

Herror interpolate_scattered_data_points_to_image(Hobject* ImageInterpolated, const HTuple& Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& Width, const HTuple& Height, const HTuple& GenParamNames, const HTuple& GenParamValues)

void InterpolateScatteredDataPointsToImage(HObject* ImageInterpolated, const HTuple& Method, const HTuple& Rows, const HTuple& Columns, const HTuple& Values, const HTuple& Width, const HTuple& Height, const HTuple& GenParamNames, const HTuple& GenParamValues)

void HOperatorSetX.InterpolateScatteredDataPointsToImage(
[out] IHUntypedObjectX*ImageInterpolated, [in] VARIANT Method, [in] VARIANT Rows, [in] VARIANT Columns, [in] VARIANT Values, [in] VARIANT Width, [in] VARIANT Height, [in] VARIANT GenParamNames, [in] VARIANT GenParamValues)

static void HOperatorSet.InterpolateScatteredDataPointsToImage(out HObject imageInterpolated, HTuple method, HTuple rows, HTuple columns, HTuple values, HTuple width, HTuple height, HTuple genParamNames, HTuple genParamValues)

Description

interpolate_scattered_data_points_to_imageinterpolate_scattered_data_points_to_imageInterpolateScatteredDataPointsToImageinterpolate_scattered_data_points_to_imageInterpolateScatteredDataPointsToImageInterpolateScatteredDataPointsToImage interpolates the data points, given in RowsRowsRowsRowsRowsrows and ColumnsColumnsColumnsColumnsColumnscolumns with the corresponding measurement ValuesValuesValuesValuesValuesvalues, and returns the result in ImageInterpolatedImageInterpolatedImageInterpolatedImageInterpolatedImageInterpolatedimageInterpolated. The size of the output image is defined by its WidthWidthWidthWidthWidthwidth and its HeightHeightHeightHeightHeightheight with the upper left corner at (0,0). In order to interpolate at negative coordinates of (RowsRowsRowsRowsRowsrows,ColumnsColumnsColumnsColumnsColumnscolumns), simply translate all input points accordingly. With the parameter MethodMethodMethodMethodMethodmethod the interpolation algorithm is specified. 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, interpolate_scattered_data_points_to_imageinterpolate_scattered_data_points_to_imageInterpolateScatteredDataPointsToImageinterpolate_scattered_data_points_to_imageInterpolateScatteredDataPointsToImageInterpolateScatteredDataPointsToImage also supports subpixel coordinates for RowsRowsRowsRowsRowsrows and ColumnsColumnsColumnsColumnsColumnscolumns. If the same data points (RowsRowsRowsRowsRowsrows,ColumnsColumnsColumnsColumnsColumnscolumns,ValuesValuesValuesValuesValuesvalues) are used for the interpolation of different output images in subsequent steps, the operator create_scattered_data_interpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorcreate_scattered_data_interpolatorCreateScatteredDataInterpolatorCreateScatteredDataInterpolator may be more efficient.

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,ValuesValuesValuesValuesValuesvalues) are interpolated exactly. With 'alpha'"alpha""alpha""alpha""alpha""alpha" getting larger, the interpolation smoothes the points in way that all interpolated points of the result image ImageInterpolatedImageInterpolatedImageInterpolatedImageInterpolatedImageInterpolatedimageInterpolated lie on a common plane. Default value is 0. Restrictions: 'alpha'"alpha""alpha""alpha""alpha""alpha" >= 0

Parallelization

Parameters

ImageInterpolatedImageInterpolatedImageInterpolatedImageInterpolatedImageInterpolatedimageInterpolated (output_object)  singlechannelimage objectHImageHImageHImageHImageXHobject * (real)

Interpolated image

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

WidthWidthWidthWidthWidthwidth (input_control)  number HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Width of the interpolated image

Default value: 640

HeightHeightHeightHeightHeightheight (input_control)  number HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Height of the interpolated image

Default value: 480

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

Result

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

Alternatives

interpolate_scattered_data_imageinterpolate_scattered_data_imageInterpolateScatteredDataImageinterpolate_scattered_data_imageInterpolateScatteredDataImageInterpolateScatteredDataImage

Module

Foundation


ClassesClassesClassesClasses | | | | Operators