ClassesClasses | | Operators

saddle_points_sub_pixT_saddle_points_sub_pixSaddlePointsSubPixSaddlePointsSubPix (Operator)

Name

saddle_points_sub_pixT_saddle_points_sub_pixSaddlePointsSubPixSaddlePointsSubPix — Subpixel precise detection of saddle points in an image.

Signature

saddle_points_sub_pix(Image : : Filter, Sigma, Threshold : Row, Column)

Herror T_saddle_points_sub_pix(const Hobject Image, const Htuple Filter, const Htuple Sigma, const Htuple Threshold, Htuple* Row, Htuple* Column)

void SaddlePointsSubPix(const HObject& Image, const HTuple& Filter, const HTuple& Sigma, const HTuple& Threshold, HTuple* Row, HTuple* Column)

void HImage::SaddlePointsSubPix(const HString& Filter, double Sigma, double Threshold, HTuple* Row, HTuple* Column) const

void HImage::SaddlePointsSubPix(const char* Filter, double Sigma, double Threshold, HTuple* Row, HTuple* Column) const

static void HOperatorSet.SaddlePointsSubPix(HObject image, HTuple filter, HTuple sigma, HTuple threshold, out HTuple row, out HTuple column)

void HImage.SaddlePointsSubPix(string filter, double sigma, double threshold, out HTuple row, out HTuple column)

Description

saddle_points_sub_pixsaddle_points_sub_pixSaddlePointsSubPixSaddlePointsSubPixSaddlePointsSubPix extracts saddle points from the image ImageImageImageImageimage with subpixel precision, i.e., points where along one direction the image intensity is minimal while at the same time along a different direction the image intensity is maximal. To do so, in each point the input image is approximated by a quadratic polynomial in x and y and subsequently the polynomial is examined for saddle points. The partial derivatives, which are necessary for setting up the polynomial, are calculated either with various Gaussian derivatives or using the facet model, depending on FilterFilterFilterFilterfilter. In the first case, SigmaSigmaSigmaSigmasigma determines the size of the Gaussian kernels, while in the second case, before being processed the input image is smoothed by a Gaussian whose size is determined by SigmaSigmaSigmaSigmasigma. Therefore, 'facet'"facet""facet""facet""facet" results in a faster extraction at the expense of slightly less accurate results. A point is accepted to be a saddle point if the absolute values of both eigenvalues of the Hessian matrix are greater than ThresholdThresholdThresholdThresholdthreshold but their signs differ. The eigenvalues correspond to the curvature of the gray value surface.

saddle_points_sub_pixsaddle_points_sub_pixSaddlePointsSubPixSaddlePointsSubPixSaddlePointsSubPix is especially useful for the detection of corners, where fields of different intensity join together like the black and white fields of a chess board. Their high contrast and shape facilitate the location and the determination of the precise position of such corners.

Attention

Note that filter operators may return unexpected results if an image with a reduced domain is used as input. Please refer to the chapter Filters.

Execution Information

Parameters

ImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHobject (byte / int1 / int2 / uint2 / int4 / real)

Input image.

FilterFilterFilterFilterfilter (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Method for the calculation of the partial derivatives.

Default value: 'facet' "facet" "facet" "facet" "facet"

List of values: 'facet'"facet""facet""facet""facet", 'gauss'"gauss""gauss""gauss""gauss"

SigmaSigmaSigmaSigmasigma (input_control)  real HTupleHTupleHtuple (real) (double) (double) (double)

Sigma of the Gaussian. If FilterFilterFilterFilterfilter is 'facet', SigmaSigmaSigmaSigmasigma may be 0.0 to avoid the smoothing of the input image.

Suggested values: 0.7, 0.8, 0.9, 1.0, 1.2, 1.5, 2.0, 3.0

Restriction: Sigma >= 0.0

ThresholdThresholdThresholdThresholdthreshold (input_control)  real HTupleHTupleHtuple (real) (double) (double) (double)

Minimum absolute value of the eigenvalues of the Hessian matrix.

Default value: 5.0

Suggested values: 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0

Restriction: Threshold >= 0.0

RowRowRowRowrow (output_control)  point.y-array HTupleHTupleHtuple (real) (double) (double) (double)

Row coordinates of the detected saddle points.

ColumnColumnColumnColumncolumn (output_control)  point.x-array HTupleHTupleHtuple (real) (double) (double) (double)

Column coordinates of the detected saddle points.

Result

saddle_points_sub_pixsaddle_points_sub_pixSaddlePointsSubPixSaddlePointsSubPixSaddlePointsSubPix returns 2 (H_MSG_TRUE) if all parameters are correct and no error occurs during the execution. If the input is empty the behavior can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Possible Successors

gen_cross_contour_xldgen_cross_contour_xldGenCrossContourXldGenCrossContourXldGenCrossContourXld, disp_crossdisp_crossDispCrossDispCrossDispCross

Alternatives

critical_points_sub_pixcritical_points_sub_pixCriticalPointsSubPixCriticalPointsSubPixCriticalPointsSubPix, local_min_sub_pixlocal_min_sub_pixLocalMinSubPixLocalMinSubPixLocalMinSubPix, local_max_sub_pixlocal_max_sub_pixLocalMaxSubPixLocalMaxSubPixLocalMaxSubPix

Module

Foundation


ClassesClasses | | Operators