# mappolyshape

## Description

A `mappolyshape`

object represents a polygon or multipolygon in
planar coordinates. A *polygon* is a region bounded by a closed curve and
can include interior holes. A *multipolygon* is an individual polygon
shape that includes multiple nonintersecting regions.

Polygons and multipolygons are useful for defining areas of interest (AOIs). For more information about AOIs, see Define Areas of Interest.

To represent a polygon or multipolygon in geographic coordinates, use a `geopolyshape`

object
instead.

## Creation

To create `mappolyshape`

objects, either:

Import polygon data in planar coordinates as a geospatial table using the

`readgeotable`

function, and then query the`Shape`

variable of the table.Create a rectangular AOI by using the

`aoiquad`

function.Create an AOI of circles by using the

`aoicircle`

function.Use the

`mappolyshape`

function (described here).

### Description

`shape = mappolyshape(`

creates a `x`

,`y`

)`mappolyshape`

object or array of `mappolyshape`

objects with vertices at the specified *x*- and
*y*-coordinates. The sizes of `x`

,
`y`

, and the `mappolyshape`

object array
`shape`

match.

The `mappolyshape`

function assumes that `x`

and
`y`

define polygons with valid topology. A polygon has valid topology when:

Region interiors are to the right as you trace boundaries from vertex to vertex.

The boundaries have no self-intersections.

In general, the outer boundaries of polygons with valid topology have vertices in clockwise order and the interior holes have vertices in counterclockwise order.

### Input Arguments

## Properties

## Object Functions

`geoplot` | Plot points, lines, and polygons on map |

`mapclip` | Clip planar shape to xy-limits or polygon |

`buffer` | Buffer shape in geographic or planar coordinates |

`area` | Area of polygon shape in geographic or planar coordinates |

`perimeter` | Perimeter of polygon shape in geographic or planar coordinates |

`bounds` | Bounds of shape in geographic or planar coordinates |

`isinterior` | Query geographic or planar points in polygon |

`ismultipoint` | Determine which array elements are multipoint shapes |

## Examples

## Version History

**Introduced in R2021b**