Skip to content

hough_circle_transhough_circle_transHoughCircleTransHoughCircleTranshough_circle_transhough_circle_transπŸ”—

Short descriptionπŸ”—

hough_circle_transhough_circle_transHoughCircleTransHoughCircleTranshough_circle_transhough_circle_trans β€” Return the Hough-Transform for circles with a given radius.

SignatureπŸ”—

hough_circle_trans( region Region, out image HoughImage, integer Radius )hough_circle_trans( Region : HoughImage : Radius : )void HoughCircleTrans( const HObject& Region, HObject* HoughImage, const HTuple& Radius )static void HOperatorSet.HoughCircleTrans( HObject region, out HObject houghImage, HTuple radius )def hough_circle_trans( region: HObject, radius: MaybeSequence[int] ) -> HObject

Herror hough_circle_trans( const Hobject Region, Hobject* HoughImage, const Hlong Radius )

Herror T_hough_circle_trans( const Hobject Region, Hobject* HoughImage, const Htuple Radius )

HImage HRegion::HoughCircleTrans( const HTuple& Radius ) const

HImage HRegion::HoughCircleTrans( Hlong Radius ) const

HImage HRegion.HoughCircleTrans( HTuple radius )

HImage HRegion.HoughCircleTrans( int radius )

DescriptionπŸ”—

The operator hough_circle_transHoughCircleTrans calculates the Hough transform for circles with a certain Radiusradiusradius in the regions passed by Regionregionregion. Hereby the centers of all possible circles in the parameter space (the Hough or accumulator space respectively) will be accumulated for each point in the image space. Circle hypotheses supported by many points in the input region thereby generate a maximum in the area showing the circle’s center in the output image (HoughImagehoughImagehough_image). The circles’ centers in the image space can be deduced from the coordinates of these maximums by subtracting the Radiusradiusradius. If more than one radius is transmitted, all Hough images will be shifted according to the maximal 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πŸ”—

Regionregionregion (input_object) region β†’ objectobjectHObjectHRegionHObjectHobject

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

HoughImagehoughImagehough_image (output_object) image(-array) β†’ object (int2)object (int2)HObject (int2)HImage (int2)HObject (int2)Hobject * (int2)

Hough transform for circles with a given radius.

Number of elements: HoughImage == Radius

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: 3 ≀ Radius (lin)
Minimum increment: 1
Recommended increment: 1

ResultπŸ”—

The operator hough_circle_transHoughCircleTrans returns the value 2 (H_MSG_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>), the behavior in case of empty region is set via set_system('empty_region_result',<Result>). If necessary an exception is raised.

ModuleπŸ”—

Foundation