Main Content

area

Area of polyshape

Description

A = area(polyin) returns the total area of a polyshape object, which is the sum of the areas of the solid regions that make up the polyshape.

example

A = area(polyin,I) returns the area of the Ith boundary of polyin. The area of a hole boundary is negative.

This syntax is only supported when polyin is a scalar polyshape object.

Examples

collapse all

Create a polygon containing multiple solid regions and one hole, and compute its area.

P = [0 0; 0 2; 2 2; 2 0; NaN NaN; 0.5 0.5; 0.5 1.5; 1.5 1.5; 1.5 0.5; NaN NaN; 3 0.5; 3.5 1.5; 4 0.5];
polyin = polyshape(P);
plot(polyin)
axis equal

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

A = area(polyin)
A = 
3.5000

Input Arguments

collapse all

Input polyshape, specified as a scalar, vector, matrix, or multidimensional array.

Data Types: polyshape

Boundary index, specified as a scalar integer or vector of integers. Each element of I corresponds to a single boundary of the input polyshape.

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

Extended Capabilities

Version History

Introduced in R2017b