hough_circleshough_circlesHoughCirclesHoughCircleshough_circles (Operator)


hough_circleshough_circlesHoughCirclesHoughCircleshough_circles — centers of circles for a specific radius.


hough_circles(RegionIn : RegionOut : Radius, Percent, Mode : )

Herror hough_circles(const Hobject RegionIn, Hobject* RegionOut, const Hlong Radius, const Hlong Percent, const Hlong Mode)

Herror T_hough_circles(const Hobject RegionIn, Hobject* RegionOut, const Htuple Radius, const Htuple Percent, const Htuple Mode)

void HoughCircles(const HObject& RegionIn, HObject* RegionOut, const HTuple& Radius, const HTuple& Percent, const HTuple& Mode)

HRegion HRegion::HoughCircles(const HTuple& Radius, const HTuple& Percent, const HTuple& Mode) const

HRegion HRegion::HoughCircles(Hlong Radius, Hlong Percent, Hlong Mode) const

static void HOperatorSet.HoughCircles(HObject regionIn, out HObject regionOut, HTuple radius, HTuple percent, HTuple mode)

HRegion HRegion.HoughCircles(HTuple radius, HTuple percent, HTuple mode)

HRegion HRegion.HoughCircles(int radius, int percent, int mode)

def hough_circles(region_in: HObject, radius: MaybeSequence[int], percent: MaybeSequence[int], mode: MaybeSequence[int]) -> HObject


hough_circle_transhough_circle_transHoughCircleTransHoughCircleTransHoughCircleTranshough_circle_trans detects the centers of circles in regions with the help of the Hough transform for circles with a specific radius.

Execution Information


RegionInRegionInRegionInRegionInregionInregion_in (input_object)  region objectHRegionHObjectHRegionHobject

Binary edge image in which the circles are to be detected.

RegionOutRegionOutRegionOutRegionOutregionOutregion_out (output_object)  region(-array) objectHRegionHObjectHRegionHobject *

Centers of those circles which are included in the edge image by PercentPercentPercentPercentpercentpercent percent.

Number of elements: RegionOut == Radius * Percent * Mode

RadiusRadiusRadiusRadiusradiusradius (input_control)  integer(-array) HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Radius of the circle to be searched in the image.

Number of elements: 1 <= Radius <= 500

Default value: 12

Typical range of values: 2 ≤ Radius Radius Radius Radius radius radius ≤ 500 (lin)

Minimum increment: 1

Recommended increment: 1

PercentPercentPercentPercentpercentpercent (input_control)  integer(-array) HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Indicates the percentage (approximately) of the (ideal) circle which must be present in the edge image RegionInRegionInRegionInRegionInregionInregion_in.

Number of elements: 1 <= Percent <= 100

Default value: 60

Typical range of values: 10 ≤ Percent Percent Percent Percent percent percent ≤ 100 (lin)

Minimum increment: 1

Recommended increment: 5

ModeModeModeModemodemode (input_control)  integer(-array) HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

The mode defines the position of the circle in question:
0 - the radius is equivalent to the outer border of the set pixels.
1 - the radius is equivalent to the centers of the circle lines' pixels.
2 - both 0 and 1 (a little more fuzzy, but more reliable in contrast to circles set slightly differently, necessitates 50 % more processing capacity compared to 0 or 1 alone).

Number of elements: 1 <= Mode <= 3

List of values: 0, 1, 2


The operator hough_circleshough_circlesHoughCirclesHoughCirclesHoughCircleshough_circles returns the value TRUE if the input is not empty. The behavior in case of empty input (no input regions available) is set via the operator 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>), the behavior in case of empty region is set via set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>). If necessary an exception is raised.