Description |
sanePColor simple wrapper for pcolor
Unlike the built-in pcolor command, this function does not "cut off" the
last row and column of the input matrix. In this way, sanePColor is
intended to be as easy to use as imagesc, but allows the user to specify
the x and y coordinates of each cell if desired. This function is also
useful as an alternative means of generating images to print to PDF that
are compatible with OS X's "Preview" PDF viewer (imagesc images appear
"blurred" when printing to a PDF as a vector graphic and viewed using
Preview).
NOTE: The imagesc function assumes that each entry in a matrix gets the
corresponding coordinate in 2-d space. For example, entry (2,3) in the
matrix is assigned to the coordinate with x = 3, y = 2 when using
imagesc. The pcolor function assumes that entries correspond to *edges*.
So entry (2,3) in a matrix corresponds to the value between 2 and 3
(along the x-axis) and between 1 and 2 (along the y-axis). This is why
one row and one column are cut off when using pcolor. sanePColor
behaves like imagesc (i.e. does not cut off data), but uses the "edge
assignment" data representation required by pcolor. sanePColor uses
linear or logarithmic interpolation to infer the edges automatically.
Usage: p = sanePColor([x,y],z,[logx],[logy]);
INPUTS:
x: an array of sorted x values. can also specify a min and max x value.
these values correspond to columns of z. [IF THIS ARGUMENT IS USED,
MUST ALSO SPECIFY Y VALUES.]
y: an array of sorted y values. can also specify a min and max y value.
these values correspond to rows of z. [IF THIS ARGUMENT IS USED,
MUST ALSO SPECIFY X VALUES.]
z: a 2d matrix of values. this matrix determines the color at each
point.
logx: if this optional argument is set to true, the x-axis will plotted
in log scale (similar to semilogx).
logy: if this optional argument is set to true, the y-axis will plotted
in log scale (similar to semilogy).
OUTPUTS:
p: a handle to the resulting pcolor image.
EXAMPLE:
m = membrane;
p = sanePColor(m);
SEE ALSO: pcolor, image, imagesc, semilogx, semilogy, loglog, padarray
AUTHOR: JEREMY R. MANNING
CONTACT: manning3@princeton.edu |