local_max_contours_xldlocal_max_contours_xldLocalMaxContoursXldLocalMaxContoursXldlocal_max_contours_xld (Operator)
Name
local_max_contours_xldlocal_max_contours_xldLocalMaxContoursXldLocalMaxContoursXldlocal_max_contours_xld — Select XLD contours with a local maximum of gray values.
Signature
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)
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