Main Content

numRegions

Number of regions in alpha shape

collapse all in page

Syntax

N = numRegions(shp)

Description

N = numRegions(shp) returns the number of distinct regions that make up the alpha shape. For an alpha radius of Inf, the alpha shape is the convex hull, and the number of regions is one. As the value of the alpha radius decreases the shape can break into separate regions, depending on the point set.

example

Examples

collapse all

Open Live Script

Create and plot a set of 2-D points.

th = (pi/12:pi/12:2*pi)';
x1 = [reshape(cos(th)*(1:5), numel(cos(th)*(1:5)),1); 0];
y1 = [reshape(sin(th)*(1:5), numel(sin(th)*(1:5)),1); 0];
x = [x1; x1+15;];
y = [y1; y1];
plot(x,y,'.')
axis equal

Figure contains an axes object. The axes contains a line object which displays its values using only markers.

Create an alpha shape using an alpha radius of 7 and query the number of distinct regions in the shape.

shp = alphaShape(x,y,7);
nregions = numRegions(shp)
nregions = 
1

Use a smaller alpha radius of 2.5 to better capture the boundary and then retrieve the new number of distinct regions.

shp.Alpha = 2.5;
nregions = numRegions(shp)
nregions = 
2

Plot the alpha shape to check the boundary quality. 

plot(shp)

Figure contains an axes object. The axes object contains an object of type patch.

Input Arguments

collapse all

Alpha shape, specified as an alphaShape object. For more information, see alphaShape.

Example: shp = alphaShape(x,y) creates a 2-D alphaShape object from the (x,y) point coordinates.

Version History

Introduced in R2014b

See Also