points_harris_binomialT_points_harris_binomialPointsHarrisBinomialPointsHarrisBinomialpoints_harris_binomial (算子)

名称

points_harris_binomialT_points_harris_binomialPointsHarrisBinomialPointsHarrisBinomialpoints_harris_binomial — 使用哈里斯(Harris)算子的二项式近似来检测感兴趣的点。

签名

points_harris_binomial(Image : : MaskSizeGrad, MaskSizeSmooth, Alpha, Threshold, Subpix : Row, Column)

Herror T_points_harris_binomial(const Hobject Image, const Htuple MaskSizeGrad, const Htuple MaskSizeSmooth, const Htuple Alpha, const Htuple Threshold, const Htuple Subpix, Htuple* Row, Htuple* Column)

void PointsHarrisBinomial(const HObject& Image, const HTuple& MaskSizeGrad, const HTuple& MaskSizeSmooth, const HTuple& Alpha, const HTuple& Threshold, const HTuple& Subpix, HTuple* Row, HTuple* Column)

void HImage::PointsHarrisBinomial(Hlong MaskSizeGrad, Hlong MaskSizeSmooth, double Alpha, const HTuple& Threshold, const HString& Subpix, HTuple* Row, HTuple* Column) const

void HImage::PointsHarrisBinomial(Hlong MaskSizeGrad, Hlong MaskSizeSmooth, double Alpha, double Threshold, const HString& Subpix, HTuple* Row, HTuple* Column) const

void HImage::PointsHarrisBinomial(Hlong MaskSizeGrad, Hlong MaskSizeSmooth, double Alpha, double Threshold, const char* Subpix, HTuple* Row, HTuple* Column) const

void HImage::PointsHarrisBinomial(Hlong MaskSizeGrad, Hlong MaskSizeSmooth, double Alpha, double Threshold, const wchar_t* Subpix, HTuple* Row, HTuple* Column) const   ( Windows only)

static void HOperatorSet.PointsHarrisBinomial(HObject image, HTuple maskSizeGrad, HTuple maskSizeSmooth, HTuple alpha, HTuple threshold, HTuple subpix, out HTuple row, out HTuple column)

void HImage.PointsHarrisBinomial(int maskSizeGrad, int maskSizeSmooth, double alpha, HTuple threshold, string subpix, out HTuple row, out HTuple column)

void HImage.PointsHarrisBinomial(int maskSizeGrad, int maskSizeSmooth, double alpha, double threshold, string subpix, out HTuple row, out HTuple column)

def points_harris_binomial(image: HObject, mask_size_grad: int, mask_size_smooth: int, alpha: float, threshold: Union[float, int], subpix: str) -> Tuple[Sequence[float], Sequence[float]]

描述

points_harrispoints_harrisPointsHarrisPointsHarrisPointsHarrispoints_harris extracts points of interest from an image ImageImageImageImageimageimage. The Harris operator is based upon the smoothed matrix where stands for a Binomial smoothing of size MaskSizeSmoothMaskSizeSmoothMaskSizeSmoothMaskSizeSmoothmaskSizeSmoothmask_size_smooth and and are the first derivatives of the image, computed with a Sobel filter of size MaskSizeGradMaskSizeGradMaskSizeGradMaskSizeGradmaskSizeGradmask_size_grad. The resulting points are the positive local extrema of If necessary, they can be restricted to points with a minimum filter response of ThresholdThresholdThresholdThresholdthresholdthreshold. By default the coordinates of the points are calculated with subpixel accuracy. This can be turned off by setting the parameter SubpixSubpixSubpixSubpixsubpixsubpix to 'off'.

注意

请注意,若使用域缩减后的图像作为输入,滤波器算子可能会返回意外结果。请参阅 滤波器 一章

执行信息

参数

ImageImageImageImageimageimage (输入对象)  (multichannel-)image objectHImageHObjectHImageHobject (byte / uint2)

输入图像。

MaskSizeGradMaskSizeGradMaskSizeGradMaskSizeGradmaskSizeGradmask_size_grad (输入控制)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Amount of binomial smoothing used for the calculation of the gradient.

默认值: 5

建议值: 3, 5, 7, 9, 11, 15, 21, 31

值范围: 1 ≤ MaskSizeGrad MaskSizeGrad MaskSizeGrad MaskSizeGrad maskSizeGrad mask_size_grad

建议增量: 2

MaskSizeSmoothMaskSizeSmoothMaskSizeSmoothMaskSizeSmoothmaskSizeSmoothmask_size_smooth (输入控制)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Amount of smoothing used for the integration of the gradients.

默认值: 15

建议值: 3, 5, 7, 9, 11, 15, 21, 31

值范围: 1 ≤ MaskSizeSmooth MaskSizeSmooth MaskSizeSmooth MaskSizeSmooth maskSizeSmooth mask_size_smooth

建议增量: 2

AlphaAlphaAlphaAlphaalphaalpha (输入控制)  real HTuplefloatHTupleHtuple (real) (double) (double) (double)

Weight of the squared trace of the squared gradient matrix.

默认值: 0.08

建议值: 0.02, 0.03, 0.04, 0.05, 0.06, 0.07, 0.08

值范围: 0.0 ≤ Alpha Alpha Alpha Alpha alpha alpha

最小增量: 0.001

建议增量: 0.01

ThresholdThresholdThresholdThresholdthresholdthreshold (输入控制)  number HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Minimum filter response for the points.

默认值: 1000.0

值范围: 0.0 ≤ Threshold Threshold Threshold Threshold threshold threshold

SubpixSubpixSubpixSubpixsubpixsubpix (输入控制)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Turn on or off subpixel refinement.

默认值: 'on' "on" "on" "on" "on" "on"

值列表: 'off'"off""off""off""off""off", 'on'"on""on""on""on""on"

RowRowRowRowrowrow (输出控制)  point.y-array HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Row coordinates of the detected points.

ColumnColumnColumnColumncolumncolumn (输出控制)  point.x-array HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Column coordinates of the detected points.

结果

points_harrispoints_harrisPointsHarrisPointsHarrisPointsHarrispoints_harris returns 2 ( H_MSG_TRUE) if all parameters are correct and no error occurs during the execution. 如果输入为空则可设置行为通过 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>)set_system("no_object_result",<Result>)。如有必要,则抛出异常。

可能的后继

gen_cross_contour_xldgen_cross_contour_xldGenCrossContourXldGenCrossContourXldGenCrossContourXldgen_cross_contour_xld

替代

points_foerstnerpoints_foerstnerPointsFoerstnerPointsFoerstnerPointsFoerstnerpoints_foerstner, points_harrispoints_harrisPointsHarrisPointsHarrisPointsHarrispoints_harris, points_lepetitpoints_lepetitPointsLepetitPointsLepetitPointsLepetitpoints_lepetit, points_sojkapoints_sojkaPointsSojkaPointsSojkaPointsSojkapoints_sojka

参考文献

C. Harris, M. Stephens: “A combined corner and edge detector”. Proceedings of the 4th Alvey Vision Conference, pp. 147-151, 1988.
V. Gouet, N.Boujemaa: “Object-based queries using color points of interest”. IEEE Workshop on Content-Based Access of Image and Video Libraries, CVPR/CBAIVL 2001, Hawaii, USA, 2001.

模块

基础