polyarea

Área de um polígono dado pelas coordenadas de seus vértices.

Categoria: Mathematics > Computational Geometry

Sintaxe

A = polyarea(x, y)

Área do polígono de vértices (x, y).

A = polyarea(x, y, dim)

Para matrizes, trata os polígonos como estando ao longo da dimensão dim.

Descrição

A área vem da fórmula do cadarço, uma soma de produtos vetoriais de vértices consecutivos. O polígono é fechado automaticamente, então o primeiro vértice não precisa ser repetido. O resultado é o valor absoluto, de modo que listas horárias e anti-horárias dão o mesmo número.

Para um polígono autointersectante, regiões percorridas em sentidos opostos se subtraem. Use polyshape para geometria robusta com furos.

Argumentos de entrada

x, y
Vetores de coordenadas dos vértices em ordem ao redor do polígono, ou matrizes com um polígono por coluna.
dim
Dimensão ao longo da qual os vértices correm.

Argumentos de saída

A
Área não negativa. Para entrada matricial, um vetor linha com uma área por coluna.

Exemplo

Um quadrado e dois retângulos

polyarea([0 1 1 0], [0 0 1 1])
X = [0 1 1 0; 0 2 2 0]';
Y = [0 0 1 1; 0 0 3 3]';
polyarea(X, Y)
Saída
ans = 1
ans = 1×2

     1     6

Veja também

area polyshape inpolygon convhull trapz