This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.


Project patch objects on map axes


h = patchm(lat,lon,cdata)
h = patchm(lat,lon,cdata,PropertyName,PropertyValue,...)
h = patchm(lat,lon,PropertyName,PropertyValue,...)
h = patchm(lat,lon,z,cdata)
h = patchm(lat,lon,z,cdata, PropertyName,PropertyValue,...)


h = patchm(lat,lon,cdata) and h = patchm(lat,lon,cdata,PropertyName,PropertyValue,...) project and display patch (polygon) objects defined by their vertices given in lat and lon on the current map axes. lat and lon must be vectors. The color data, cdata, can be any color data designation supported by the standard MATLAB® patch function. The object handle or handles, h, can be returned.

h = patchm(lat,lon,PropertyName,PropertyValue,...) allows any property name/property value pair supported by patch to be assigned to the patchm object.

h = patchm(lat,lon,z,cdata) and h = patchm(lat,lon,z,cdata, PropertyName,PropertyValue,...) allow the assignment of an altitude, z, to each patch object. The default altitude is z = 0.


collapse all

Project coastline data as single patch object on map axes.

load coastlines
axesm sinusoid;
h = patchm(coastlat,coastlon,'b');
ans =



How patchm Works

This Mapping Toolbox™ function is very similar to the standard MATLAB patch function. Like its analog, and unlike higher level functions such as fillm and fill3m, patchm adds patch objects to the current map axes regardless of hold state. Except for XData, YData, and ZData, all line properties and styles available through patch are supported by patchm.

When A Patch Is Completely Trimmed Away

Removing graphic objects that fall outside the map frame is called trimming. If, after trimming to the map frame no polygons remain to be seen within it, patchm creates no patches and returns an empty 0-by-1 handle. When this occurs, automatic reprojection of the patch data (by changing the projection or any of its parameters) will not be possible. Instead, after changing the projection, call patchm again.

See Also

| |

Introduced before R2006a

Was this topic helpful?