Main Content

circles2mask

Create binary masks from circles

Since R2024a

collapse all in page

Syntax

mask = circles2mask(centers,radii,maskSize)

Description

example

mask = circles2mask(centers,radii,maskSize) creates a binary mask image from circles specified by center coordinates centers and radius lengths radii. The maskSize argument specifies the dimensions of the output binary mask, mask.

Examples

collapse all

Open Live Script

Load a grayscale image into the workspace and display it.

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

Find all the circles with radii in the range [20, 35] pixels.

[centers,radii] = imfindcircles(A,[20 35],Sensitivity=0.9);

Create a binary mask image that contains masks for the detected circles.

mask = circles2mask(centers,radii,size(A));

Display the original image and the mask image.

figure
montage({A,mask})

Input Arguments

collapse all

Circle centers, specified as a P-by-2 matrix. Each row specifies the xy-coordinates of a circle center. You can specify this argument using the centers output of the imfindcircles function.

Data Types: double

Circle radii, specified as a vector. You can specify this argument using the radii output of the imfindcircles function.

Data Types: double

Mask image size, specified as a 2-element row vector of nonnegative integers of the form [height width]. This argument specifies the dimensions of the output binary mask, mask, in pixels.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Output Arguments

collapse all

Binary mask image, returned as a logical matrix of the size specified by the maskSize argument.

Data Types: logical

Tips

  • circles2mask can generate masks for circles with centers outside the bounds of the image.

Extended Capabilities

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

Version History

Introduced in R2024a

See Also

| |

Topics