polyarea

Área de un polígono

Sintaxis

a = polyarea(x,y)

a = polyarea(x,y,dim)

Descripción

a = polyarea(x,y) devuelve el área de un polígono 2D definido por los vértices de los vectores x e y.

• Si x e y son vectores de la misma longitud, polyarea devuelve el área escalar del polígono definido por x e y.

• Si x e y son matrices del mismo tamaño, polyarea devuelve un vector fila que contiene las áreas de cada polígono definido por los pares columna de x e y.

• Si x e y son arreglos multidimensionales, polyarea opera en la primera dimensión cuya longitud no es igual a 1.

a = polyarea(x,y,dim) opera en la dimensión dim.

Ejemplos

Área de un polígono

Cree un conjunto de puntos que definan un polígono 2D.

p = linspace(0,2.*pi,9);
x = 1.2*cos(p)';
y = 1.2*sin(p)'; 

Represente el polígono.

plot(x,y);
axis equal

Calcule el área del polígono.

a = polyarea(x,y)

a = 
4.0729

Argumentos de entrada

x — Coordenadas x

vector | matriz | arreglo multidimensional

Coordenadas x, especificadas como vector, matriz o arreglo multidimensional.

y — Coordenadas y

vector | matriz | arreglo multidimensional

Coordenadas y, especificadas como vector, matriz o arreglo multidimensional.

dim — Dimensión

escalar entero positivo

Dimensión en la que operar, especificada como escalar entero positivo.

Sugerencias

• El valor del área devuelto por polyarea puede depender del orden de los puntos de entrada.

Capacidades ampliadas

Generación de código C/C++
Genere código C y C++ mediante MATLAB® Coder™.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función polyarea es totalmente compatible con los arreglos de GPU. Para ejecutar la función en una GPU, especifique los datos de entrada como un gpuArray (Parallel Computing Toolbox). Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

Consulte también

nsidedpoly | polyshape | inpolygon | rectint