pcolorm
Project regular data grid on map axes in z = 0 plane
Syntax
pcolorm(lat,lon,Z)
pcolorm(latlim,lonlim,Z)
pcolorm(...,prop1,val1,prop2,val2,...)
h = pcolorm(...)
Description
pcolorm(lat,lon,Z) constructs
a surface to represent the data grid Z in the current
map axes. The surface lies flat in the horizontal plane with its CData property
set to Z. Lat and lon are
vectors or 2-D arrays that define the latitude-longitude graticule
mesh on which Z is displayed. For a complete description
of the various forms that lat and lon can
take, see surfm. If the hold state
is 'off', pcolorm clears the
current map.
pcolorm(latlim,lonlim,Z) defines
the graticule using the latitude and longitude limits latlim and lonlim.
These limits should match the geographic extent of Z,
the data grid. Latlim is a two-element vector of
the form:
[southern_limit northern_limit]
Likewise, lonlim has the form:
[western_limit eastern_limit]
A latitude-longitude graticule of size 50-by-100 is constructed.
The surface FaceColor property is 'texturemap',
except when Z is precisely 50-by-100, in which
case it is 'flat'.
pcolorm(...,prop1,val1,prop2,val2,...) applies
additional MATLAB® graphics properties to the surface via property/value
pairs. Any property accepted by the surface may
be specified, except for XData, YData,
and ZData.
h = pcolorm(...) returns
a handle to the surface object.
Examples
Load elevation raster data and a geographic cells reference object. Then, display the data as a surface.
load topo60c axesm miller axis off framem on gridm on [lat,lon] = meshgrat(topo60c,topo60cR,[90 180]); pcolorm(lat,lon,topo60c) demcmap(topo60c) tightmap
Tips
This function warps a data grid to a graticule mesh, which 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 fewer graticule points in the longitudinal direction
than do complex curve-generating projections.