Operator Reference

HALCON Operator Reference / XLD / Features
ClassesClasses | | Operators

local_max_contours_xldlocal_max_contours_xldLocalMaxContoursXldLocalMaxContoursXldlocal_max_contours_xld (Operator)

local_max_contours_xldlocal_max_contours_xldLocalMaxContoursXldLocalMaxContoursXldlocal_max_contours_xld — Select XLD contours with a local maximum of gray values.

Signature

local_max_contours_xld(Contours, Image : LocalMaxContours : MinPercent, MinDiff, Distance : )

Herror local_max_contours_xld(const Hobject Contours, const Hobject Image, Hobject* LocalMaxContours, const Hlong MinPercent, const Hlong MinDiff, const Hlong Distance)

Herror T_local_max_contours_xld(const Hobject Contours, const Hobject Image, Hobject* LocalMaxContours, const Htuple MinPercent, const Htuple MinDiff, const Htuple Distance)

void LocalMaxContoursXld(const HObject& Contours, const HObject& Image, HObject* LocalMaxContours, const HTuple& MinPercent, const HTuple& MinDiff, const HTuple& Distance)

HXLDCont HXLDCont::LocalMaxContoursXld(const HImage& Image, const HTuple& MinPercent, Hlong MinDiff, Hlong Distance) const

HXLDCont HXLDCont::LocalMaxContoursXld(const HImage& Image, Hlong MinPercent, Hlong MinDiff, Hlong Distance) const

static void HOperatorSet.LocalMaxContoursXld(HObject contours, HObject image, out HObject localMaxContours, HTuple minPercent, HTuple minDiff, HTuple distance)

HXLDCont HXLDCont.LocalMaxContoursXld(HImage image, HTuple minPercent, int minDiff, int distance)

HXLDCont HXLDCont.LocalMaxContoursXld(HImage image, int minPercent, int minDiff, int distance)

def local_max_contours_xld(contours: HObject, image: HObject, min_percent: Union[int, float], min_diff: int, distance: int) -> HObject

Description

local_max_contours_xldlocal_max_contours_xldLocalMaxContoursXldLocalMaxContoursXldlocal_max_contours_xld selects XLD contours from the contours passed in ContoursContoursContourscontourscontours, which have a local maximum in gray values across the direction of the contour. In order to be selected, at least MinPercentMinPercentMinPercentminPercentmin_percent of the contour points must have a local maximum perpendicular to the direction of the contour. The contours' direction is determined by fitting a regression line through five neighboring points of the contour. In order to decide whether there is a local maximum for a contour point, a gray value profile that is DistanceDistanceDistancedistancedistance points wide and perpendicular to the contour is computed on both sides of the contour. If the gray value at the contour point is at least MinDiffMinDiffMinDiffminDiffmin_diff larger than the gray value at at least one point on each side of the profile, the contour point is labeled as a local maximum. The selected contours are returned in LocalMaxContoursLocalMaxContoursLocalMaxContourslocalMaxContourslocal_max_contours.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

ContoursContoursContourscontourscontours (input_object)  xld_cont-array → objectHXLDContHObjectHObjectHobject

XLD contours to be examined.

ImageImageImageimageimage (input_object)  singlechannelimage → objectHImageHObjectHObjectHobject (byte)

Corresponding gray value image.

LocalMaxContoursLocalMaxContoursLocalMaxContourslocalMaxContourslocal_max_contours (output_object)  xld_cont-array → objectHXLDContHObjectHObjectHobject *

Selected contours.

MinPercentMinPercentMinPercentminPercentmin_percent (input_control)  number → HTupleUnion[int, float]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)

Minimum percentage of maximum points.

Default: 70

Suggested values: 60, 70, 75, 80, 85, 90, 95

Restriction: 0.0 <= MinPercent && MinPercent <= 100.0

MinDiffMinDiffMinDiffminDiffmin_diff (input_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Minimum amount by which the gray value at the maximum must be larger than in the profile.

Default: 15

Suggested values: 5, 8, 10, 12, 15, 20

Restriction: 0 <= MinDiff && MinDiff <= 255

DistanceDistanceDistancedistancedistance (input_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Maximum width of profile used to check for maxima.

Default: 4

Suggested values: 2, 3, 4, 5, 6

Restriction: Distance >= 1

Possible Predecessors

gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld, lines_gausslines_gaussLinesGaussLinesGausslines_gauss, lines_facetlines_facetLinesFacetLinesFacetlines_facet, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixedges_sub_pix

Possible Successors

gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldgen_polygons_xld

See also

smooth_contours_xldsmooth_contours_xldSmoothContoursXldSmoothContoursXldsmooth_contours_xld

Module

Foundation

ClassesClasses | | Operators