Mapping Toolbox

patchesm

Project patches onto the current map axes as separate objects

Syntax

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

Description

This command is very similar to the patchm command. The significant difference is that in patchesm, separate patches (delineated by NaNs in the inputs lat and lon) are separated and plotted as distinct patch objects on the current map axes. The advantage to this is that less memory is required. The disadvantage is that multifaced objects cannot be treated as a single object. For example, the archipelago of the Philippines cannot be treated and handled as a single handle graphics object.

h = patchesm(lat,lon,cdata) projects and displays 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 command. The object handle or handles, h, can be returned.

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

h = patchesm(lat,lon,z,cdata) allows the assignment of an altitude, z, to each patch object. The default altitude is z = 0.

Examples

• load coast
  axesm sinusoid; framem
  h = patchesm(lat,long,'b');
  
  
  
  
  length(h)
  ans =
     238
  

See Also

patchm	Project patch objects on the current map axes
fill3m	Project 3-D patch objects onto the current map axes
fillm	Project 2-D patch objects onto the current map axes

par2geod

patchm