imfindcircles

Find circles using circular Hough transform

Syntax

centers = imfindcircles(A,radius)

[centers,radii]
= imfindcircles(A,radiusRange)

[centers,radii,metric]
= imfindcircles(A,radiusRange)

[___]
= imfindcircles(___,Name=Value)

Description

centers = imfindcircles(A,radius) finds the circles in image A whose radii are approximately equal to radius. The output, centers, is a two-column matrix containing the (x,y) coordinates of the circle centers in the image.

[centers,radii] = imfindcircles(A,radiusRange) finds circles with radii in the range specified by radiusRange. The additional output argument, radii, contains the estimated radii corresponding to each circle center in centers.

[centers,radii,metric] = imfindcircles(A,radiusRange) also returns a column vector, metric, containing the magnitudes of the accumulator array peaks for each circle (in descending order). The rows of centers and radii correspond to the rows of metric.

example

[___] = imfindcircles(___,Name=Value) specifies additional options with one or more name-value arguments, using any of the previous syntaxes.

example

Examples

collapse all

Detect Five Strongest Circles in an Image

Open Live Script

This example shows how to find all circles in an image, and how to retain and display the strongest circles.

Read a grayscale image into the workspace and display it.

A = imread('coins.png');
imshow(A)

Figure contains an axes object. The hidden axes object contains an object of type image.

Find all the circles with radius r pixels in the range [15, 30].

[centers, radii, metric] = imfindcircles(A,[15 30]);

Retain the five strongest circles according to the metric values.

centersStrong5 = centers(1:5,:); 
radiiStrong5 = radii(1:5);
metricStrong5 = metric(1:5);

Draw the five strongest circle perimeters over the original image.

viscircles(centersStrong5, radiiStrong5,'EdgeColor','b');

Figure contains an axes object. The hidden axes object contains 3 objects of type line, image.

Draw Lines Around Bright and Dark Circles in Image

Open Live Script

Read the image into the workspace and display it.

A = imread('circlesBrightDark.png');
imshow(A)

Figure contains an axes object. The hidden axes object contains an object of type image.

Define the radius range.

Rmin = 30;
Rmax = 65;

Find all the bright circles in the image within the radius range.

[centersBright, radiiBright] = imfindcircles(A,[Rmin Rmax],'ObjectPolarity','bright');

Find all the dark circles in the image within the radius range.

[centersDark, radiiDark] = imfindcircles(A,[Rmin Rmax],'ObjectPolarity','dark');

Draw blue lines around the edges of the bright circles.

viscircles(centersBright, radiiBright,'Color','b');

Figure contains an axes object. The hidden axes object contains 3 objects of type line, image.

Draw red dashed lines around the edges of the dark circles.

viscircles(centersDark, radiiDark,'LineStyle','--');

Figure contains an axes object. The hidden axes object contains 5 objects of type line, image.

Input Arguments

collapse all

`A` — Input image
grayscale image | truecolor image | binary image

Input image in which to detect circular objects, specified as a grayscale, truecolor (RGB), or binary image.

`radius` — Circle radius
positive number

Circle radius, or the approximate radius of the circular objects you want to detect, specified as a positive number.

`radiusRange` — Range of radii
2-element vector of positive integers

Range of radii for the circular objects you want to detect, specified as a 2-element vector of positive integers of the form [rmin rmax], where rmin is less than rmax.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: centers = imfindcircles(A,radius,ObjectPolarity=bright) specifies bright circular objects on a dark background.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: centers = imfindcircles(A,radius,"ObjectPolarity","bright") specifies bright circular objects on a dark background.

`ObjectPolarity` — Object polarity
`"bright"` (default) | `"dark"`

Object polarity, specified as one of the values in the table.

`"bright"`	The circular objects are brighter than the background.
`"dark"`	The circular objects are darker than the background.

`Method` — Computation method
`"PhaseCode"` (default) | `"TwoStage"`

Computation method used to compute the accumulator array, specified as one of the values in the table.

`"PhaseCode"`	Atherton and Kerbyson's [1] phase-coding method.
`"TwoStage"`	The method used in the two-stage circular Hough transform [2], [3].

Example: "Method","PhaseCode" specifies the Atherton and Kerbyson's phase-coding method.

`Sensitivity` — Sensitivity factor
`0.85` (default) | number in the range [0, 1]

Sensitivity factor for the circular Hough transform accumulator array, specified as a number in the range [0, 1]. As you increase the sensitivity factor, imfindcircles detects more circular objects, including weak and partially obscured circles. Higher sensitivity values also increase the risk of false detection.

`EdgeThreshold` — Edge gradient threshold
number in the range [0, 1]

Edge gradient threshold for determining edge pixels in the image, specified as a number in the range [0, 1]. Specify 0 to set the threshold to zero-gradient magnitude. Specify 1 to set the threshold to the maximum gradient magnitude. imfindcircles detects more circular objects (with both weak and strong edges) when you set the threshold to a lower value. It detects fewer circles with weak edges as you increase the value of the threshold. By default, imfindcircles chooses the edge gradient threshold automatically using the function graythresh.

Example: "EdgeThreshold",0.5

Output Arguments

collapse all

`centers` — Coordinates of circle centers
P-by-`2` matrix

Coordinates of the circle centers, returned as a P-by-2 matrix containing the x-coordinates of the circle centers in the first column and the y-coordinates in the second column. The number of rows, P, is the number of circles detected. centers is sorted based on the strength of the circles, from strongest to weakest.

Data Types: double

`radii` — Estimated radii
column vector

The estimated radii of the circle centers, returned as a column vector. The radius value at radii(j) corresponds to the circle centered at centers(j,:).

Data Types: double

`metric` — Circle strengths
column vector

Circle strengths provides the relative strengths of the circle centers, returned as a column vector. The value at metric(j) corresponds to the circle with radius radii(j) centered at centers(j,:).

Data Types: double

Tips

The accuracy of imfindcircles is limited when the value of radius (or rmin) is less than or equal to 5.
The radius estimation step is typically faster if you use the (default) "PhaseCode" method instead of "TwoStage".
Both computation methods, "PhaseCode" and "TwoStage" are limited in their ability to detect concentric circles. The results for concentric circles can vary depending on the input image.
imfindcircles does not find circles with centers outside the domain of the image.
imfindcircles converts truecolor images to grayscale using the function rgb2gray before processing them. Binary (logical) and integer type images are converted to the data type single using the im2single function before processing. To improve the accuracy of the result for binary images, imfindcircles also applies Gaussian smoothing using imfilter as a preprocessing step.

Algorithms

imfindcircles uses a Circular Hough Transform (CHT) based algorithm for finding circles in images. This approach is used because of its robustness in the presence of noise, occlusion and varying illumination.

The CHT is not a rigorously specified algorithm, rather there are a number of different approaches that can be taken in its implementation. However, there are three important steps which are common to all approaches.

Accumulator Array Computation
Foreground pixels of high gradient are designated as being candidate pixels and are allowed to cast ‘votes’ in the accumulator array. In a classical CHT implementation, the candidate pixels vote in pattern around them that forms a full circle of a fixed radius. Figure 1a shows an example of a candidate pixel lying on an actual circle (solid circle) and the classical CHT voting pattern (dashed circles) for the candidate pixel.
Classical CHT Voting Pattern
Center Estimation
The votes of candidate pixels belonging to an image circle tend to accumulate at the accumulator array bin corresponding to the circle’s center. Therefore, the circle centers are estimated by detecting the peaks in the accumulator array. Figure 1b shows an example of the candidate pixels (solid dots) lying on an actual circle (solid circle), and their voting patterns (dashed circles) which coincide at the center of the actual circle.
Radius Estimation
If the same accumulator array is used for more than one radius value, as is commonly done in CHT algorithms, radii of the detected circles have to be estimated as a separate step.

imfindcircles provides two algorithms for finding circles in images: phase-coding (default) and two-stage. Both share some common computational steps, but each has its own unique aspects as well.

The common computational features shared by both algorithms are as follows:

Use of 2-D Accumulator Array
The classical Hough Transform requires a 3-D array for storing votes for multiple radii, which results in large storage requirements and long processing times. Both the phase-coding and two-stage methods solve this problem by using a single 2-D accumulator array for all the radii. Although this approach requires an additional step of radius estimation, the overall computational load is typically lower, especially when working over a large radius range. This is a widely adopted practice in modern CHT implementations.
Use of Edge Pixels
Overall memory requirements and speed are strongly governed by the number of candidate pixels. To limit their number, the gradient magnitude of the input image is thresholded so that only pixels of high gradient are included in tallying votes.
Use of Edge Orientation Information
Performance is also optimized by restricting the number of bins available to candidate pixels. This is accomplished by using locally available edge information to only permit voting in a limited interval along direction of the gradient (Figure 2). The width of the voting interval, between points c_min and c_max in the figure, is determined by the radius range defined by r_min and r_max.
Voting Mode: Multiple Radii, Along Direction of Gradient

r_min	Minimum search radius
r_max	Maximum search radius
r_actual	Radius of the circle that the candidate pixel belongs to
c_min	Center of the circle of radius r_min
c_max	Center of the circle of radius r_max
c_actual	Center of the circle of radius r_actual

The two CHT methods employed by the function imfindcircles fundamentally differ in the manner by which the circle radii are computed.

Two-Stage
Radii are explicitly estimated using the estimated circle centers along with image information. The technique is based on computing radial histograms [2] [3].
Phase-Coding
Radii are estimated from complex values in the accumulator array, with the radius information encoded in the phase of the array entries [1]. The votes cast by the edge pixels contain information not only about the possible center locations but also about the radius of the circle associated with the center location. Unlike the two-stage method where the radius has to be estimated explicitly using radial histograms, in phase-coding the radius can be estimated by simply decoding the phase information from the estimated center location in the accumulator array.

References

[1] T.J Atherton, D.J. Kerbyson. "Size invariant circle detection." Image and Vision Computing. Volume 17, Number 11, 1999, pp. 795-803.

[2] H.K Yuen, .J. Princen, J. Illingworth, and J. Kittler. "Comparative study of Hough transform methods for circle finding." Image and Vision Computing. Volume 8, Number 1, 1990, pp. 71–77.

[3] E.R. Davies, Machine Vision: Theory, Algorithms, Practicalities. Chapter 10. 3rd Edition. Morgan Kauffman Publishers, 2005.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

imfindcircles supports the generation of C code (requires MATLAB^® Coder™). Note that if you choose the generic MATLAB Host Computer target platform, imfindcircles generates code that uses a precompiled, platform-specific shared library. Use of a shared library preserves performance optimizations but limits the target platforms for which code can be generated. For more information, see Types of Code Generation Support in Image Processing Toolbox.
When generating code, all character vector input parameters and values must be a compile-time constant.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Usage notes and limitations:

When the sensitivity factor is near or equal to 1, there may be minor mismatch between the results from the generated code and MATLAB simulation.

Version History

Introduced in R2012a

expand all

R2022a: Generate CUDA code using GPU Coder

imfindcircles now supports the generation of optimized CUDA^® code (requires GPU Coder™).

R2019a: New filter size for logical images

Staring in R2019a, the imfindcircles function uses a 5-by-5 filter size for smoothing logical images. imfindcircles may now return a different answer than in previous releases, when the filter size was 6-by-6. For example, in some instances, the function may return a different number of circles.

imfindcircles

Syntax

Description

Examples

Detect Five Strongest Circles in an Image

Draw Lines Around Bright and Dark Circles in Image

Input Arguments

`A` — Input image
grayscale image | truecolor image | binary image

`radius` — Circle radius
positive number

`radiusRange` — Range of radii
2-element vector of positive integers

Name-Value Arguments

`ObjectPolarity` — Object polarity
`"bright"` (default) | `"dark"`

`Method` — Computation method
`"PhaseCode"` (default) | `"TwoStage"`

`Sensitivity` — Sensitivity factor
`0.85` (default) | number in the range [0, 1]

`EdgeThreshold` — Edge gradient threshold
number in the range [0, 1]

Output Arguments

`centers` — Coordinates of circle centers
P-by-`2` matrix

`radii` — Estimated radii
column vector

`metric` — Circle strengths
column vector

Tips

Algorithms

References

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Version History

R2022a: Generate CUDA code using GPU Coder

R2019a: New filter size for logical images

See Also

Topics

imfindcircles

Syntax

Description

Examples

Detect Five Strongest Circles in an Image

Draw Lines Around Bright and Dark Circles in Image

Input Arguments

A — Input image grayscale image | truecolor image | binary image

radius — Circle radius positive number

radiusRange — Range of radii 2-element vector of positive integers

Name-Value Arguments

ObjectPolarity — Object polarity "bright" (default) | "dark"

Method — Computation method "PhaseCode" (default) | "TwoStage"

Sensitivity — Sensitivity factor 0.85 (default) | number in the range [0, 1]

EdgeThreshold — Edge gradient threshold number in the range [0, 1]

Output Arguments

centers — Coordinates of circle centers P-by-2 matrix

radii — Estimated radii column vector

metric — Circle strengths column vector

Tips

Algorithms

References

Extended Capabilities

C/C++ Code Generation Generate C and C++ code using MATLAB® Coder™.

GPU Code Generation Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Version History

R2022a: Generate CUDA code using GPU Coder

R2019a: New filter size for logical images

See Also

Topics

`A` — Input image
grayscale image | truecolor image | binary image

`radius` — Circle radius
positive number

`radiusRange` — Range of radii
2-element vector of positive integers

`ObjectPolarity` — Object polarity
`"bright"` (default) | `"dark"`

`Method` — Computation method
`"PhaseCode"` (default) | `"TwoStage"`

`Sensitivity` — Sensitivity factor
`0.85` (default) | number in the range [0, 1]

`EdgeThreshold` — Edge gradient threshold
number in the range [0, 1]

`centers` — Coordinates of circle centers
P-by-`2` matrix

`radii` — Estimated radii
column vector

`metric` — Circle strengths
column vector

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.