points_lepetitT_points_lepetitPointsLepetitPointsLepetit (Operator)

Name

points_lepetitT_points_lepetitPointsLepetitPointsLepetit — Detect points of interest using the Lepetit operator.

Signature

points_lepetit(Image : : Radius, CheckNeighbor, MinCheckNeighborDiff, MinScore, Subpix : Row, Column)

Herror T_points_lepetit(const Hobject Image, const Htuple Radius, const Htuple CheckNeighbor, const Htuple MinCheckNeighborDiff, const Htuple MinScore, const Htuple Subpix, Htuple* Row, Htuple* Column)

void PointsLepetit(const HObject& Image, const HTuple& Radius, const HTuple& CheckNeighbor, const HTuple& MinCheckNeighborDiff, const HTuple& MinScore, const HTuple& Subpix, HTuple* Row, HTuple* Column)

void HImage::PointsLepetit(Hlong Radius, Hlong CheckNeighbor, Hlong MinCheckNeighborDiff, Hlong MinScore, const HString& Subpix, HTuple* Row, HTuple* Column) const

void HImage::PointsLepetit(Hlong Radius, Hlong CheckNeighbor, Hlong MinCheckNeighborDiff, Hlong MinScore, const char* Subpix, HTuple* Row, HTuple* Column) const

void HImage::PointsLepetit(Hlong Radius, Hlong CheckNeighbor, Hlong MinCheckNeighborDiff, Hlong MinScore, const wchar_t* Subpix, HTuple* Row, HTuple* Column) const   (Windows only)

static void HOperatorSet.PointsLepetit(HObject image, HTuple radius, HTuple checkNeighbor, HTuple minCheckNeighborDiff, HTuple minScore, HTuple subpix, out HTuple row, out HTuple column)

void HImage.PointsLepetit(int radius, int checkNeighbor, int minCheckNeighborDiff, int minScore, string subpix, out HTuple row, out HTuple column)

Description

points_lepetitpoints_lepetitPointsLepetitPointsLepetitPointsLepetit extracts points of interest like corners or blob-like structures from ImageImageImageImageimage. The ImageImageImageImageimage is first smoothed with a median of size 3x3. Then, all the gray values on a circle with radius RadiusRadiusRadiusRadiusradius around an interest point candidate (m) are examined. The absolute differences of two diagonally opposed gray values (m1,m2) on the circle to the central pixel m is computed. At least one of these differences has to be larger than MinCheckNeighborDiffMinCheckNeighborDiffMinCheckNeighborDiffMinCheckNeighborDiffminCheckNeighborDiff. All diagonally opposed pixels on the circle must fulfill that condition. To suppress detection of points at edges that have a small curvature (aliasing), it is possible to compute CheckNeighborCheckNeighborCheckNeighborCheckNeighborcheckNeighbor further differences of circle point neighbors of m1 and m2 to the center, that as well fulfill the above criteria. By computing all gray value differences of the circle points to the center, a mean gray value difference is determined. That value has to be larger than MinScoreMinScoreMinScoreMinScoreminScore and allows to restrict the results to points with high contrast. By computing the score of all eight neighbors of m, it is possible to fit a quadratic equation to that. The maxima of that equation determines a subpixel accurate interest point position. By setting the parameter SubpixSubpixSubpixSubpixsubpix to 'interpolation' (default) or 'none', it is possible to turn that refinement step on or off. The resulting points are returned in RowRowRowRowrow and ColumnColumnColumnColumncolumn. The operator points_lepetitpoints_lepetitPointsLepetitPointsLepetitPointsLepetit can especially be used for very fast interest point extraction. The results are however less robust than points extracted by points_harrispoints_harrisPointsHarrisPointsHarrisPointsHarris for example.

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 / uint2)

Input image.

RadiusRadiusRadiusRadiusradius (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Radius of the circle.

Default value: 3

Suggested values: 3, 5, 6, 7, 8, 9, 10, 15

CheckNeighborCheckNeighborCheckNeighborCheckNeighborcheckNeighbor (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of checked neighbors on the circle.

Default value: 1

Suggested values: 1, 2, 3, 5

MinCheckNeighborDiffMinCheckNeighborDiffMinCheckNeighborDiffMinCheckNeighborDiffminCheckNeighborDiff (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Threshold of grayvalue difference to each circle point.

Default value: 15

Suggested values: 10, 15, 20, 25, 30, 35, 40, 45, 60, 80

MinScoreMinScoreMinScoreMinScoreminScore (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Threshold of grayvalue difference to all circle points.

Default value: 30

Suggested values: 5, 10, 15, 20, 25, 30

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

Subpixel accuracy of point coordinates.

Default value: 'interpolation' "interpolation" "interpolation" "interpolation" "interpolation"

List of values: 'interpolation'"interpolation""interpolation""interpolation""interpolation", 'none'"none""none""none""none"

RowRowRowRowrow (output_control)  point.y-array HTupleHTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)

Row-coordinates of the detected points.

ColumnColumnColumnColumncolumn (output_control)  point.x-array HTupleHTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)

Column-coordinates of the detected points.

Possible Predecessors

gauss_filtergauss_filterGaussFilterGaussFilterGaussFilter

Alternatives

points_foerstnerpoints_foerstnerPointsFoerstnerPointsFoerstnerPointsFoerstner, points_harrispoints_harrisPointsHarrisPointsHarrisPointsHarris, points_harris_binomialpoints_harris_binomialPointsHarrisBinomialPointsHarrisBinomialPointsHarrisBinomial, points_sojkapoints_sojkaPointsSojkaPointsSojkaPointsSojka

Module

Foundation