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 theShape
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