Skip to content

hough_circleshough_circlesHoughCirclesHoughCircleshough_circleshough_circlesπŸ”—

Short descriptionπŸ”—

hough_circleshough_circlesHoughCirclesHoughCircleshough_circleshough_circles β€” Detect centers of circles for a specific radius using the Hough transform.

SignatureπŸ”—

hough_circles( region RegionIn, out region RegionOut, integer Radius, integer Percent, integer Mode )hough_circles( RegionIn : RegionOut : Radius, Percent, Mode : )void HoughCircles( const HObject& RegionIn, HObject* RegionOut, const HTuple& Radius, const HTuple& Percent, const HTuple& Mode )static void HOperatorSet.HoughCircles( HObject regionIn, out HObject regionOut, HTuple radius, HTuple percent, HTuple mode )def hough_circles( region_in: HObject, radius: MaybeSequence[int], percent: MaybeSequence[int], mode: MaybeSequence[int] ) -> HObject

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 )

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

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

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

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

DescriptionπŸ”—

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

Execution informationπŸ”—

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πŸ”—

RegionInregionInregion_in (input_object) region β†’ objectobjectHObjectHRegionHObjectHobject

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

RegionOutregionOutregion_out (output_object) region(-array) β†’ objectobjectHObjectHRegionHObjectHobject *

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

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

Radiusradiusradius (input_control) integer(-array) β†’ (integer)(integer)HTuple (Hlong)HTuple (int / long)MaybeSequence[int]Htuple (Hlong)

Radius of the circle to be searched in the image.

Number of elements: 1 <= Radius <= 500
Default: 1212
Value range: 2 ≀ Radius ≀ 500 (lin)
Minimum increment: 1
Recommended increment: 1

Percentpercentpercent (input_control) integer(-array) β†’ (integer)(integer)HTuple (Hlong)HTuple (int / long)MaybeSequence[int]Htuple (Hlong)

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

Number of elements: 1 <= Percent <= 100
Default: 6060
Value range: 10 ≀ Percent ≀ 100 (lin)
Minimum increment: 1
Recommended increment: 5

Modemodemode (input_control) integer(-array) β†’ (integer)(integer)HTuple (Hlong)HTuple (int / long)MaybeSequence[int]Htuple (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, 20, 1, 2

ResultπŸ”—

The operator hough_circlesHoughCircles returns the value 2 (H_MSG_TRUE) if the input is not empty. The clipping according to the global image size is set via the operator set_system('clip_region',<'true'/'false'>). The behavior in case of empty input (no input regions available) is set via the operator set_system('no_object_result',<Result>), the behavior in case of empty region is set via set_system('empty_region_result',<Result>). If necessary an exception is raised.

ModuleπŸ”—

Foundation