Mapping Toolbox

pcolorm

Project data grid in the z = 0 plane

Syntax

h = pcolorm(map) projects the data grid map on a graticule grid the size of map between the latitude and longitude limits of the current map axes. The handle h of the displayed surface can be returned.

h = pcolorm(map,npts) results in a graticule grid defined by npts, which is a two-element vector of the form [latitude-points longitude-points]. The default npts is [50 100].

h = pcolorm(lat,lon,map) allows three other methods of defining the graticule grid. If lat and lon are matrices, they represent the actual graticule vertices as might be returned by meshgrat. If vectors, they are the representative coordinates of the rows and columns, respectively, of such a grid. If they are two-element vectors, they are treated as latitude and longitude limits, and a graticule mesh the size of the default npts is calculated.

h = pcolorm(lat,lon,map,PropertyName,PropertyValue,...) allows the input of property name/property value pairs to control the surface object properties. Any property supported by the standard MATLAB function surface except XData, YData, and ZData can be altered in this manner.

Description

This function warps a data grid to a graticule mesh, which itself is projected according to the map axes property MapProjection. The fineness, or resolution, of this grid determines the quality of the projection and the speed of plotting it. There is no hard and fast rule for sufficient graticule resolution, but in general, cylindrical projections need very few graticule points in the longitudinal direction, while complex curve-generating projections require more.

Examples

• load topo
  axesm miller
  pcolorm(topo,[30 30])
  demcmap(topo)
  
  
  

See Also

meshgrat	Construct map graticule grid
meshm	Regular data grid warped to a projected graticule mesh
surfacem	Data grid warped to a projected graticule mesh
surfm	Data grid projected to a map axes

patchm

pix2latlon