@@ -5484,15 +5484,21 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
54845484origin = None ,extent = None ,shape = None ,filternorm = 1 ,
54855485filterrad = 4.0 ,imlim = None ,resample = None ,url = None ,** kwargs ):
54865486"""
5487- Display an image, i.e. data on a 2D regular raster.
5487+ Display data as an image; i.e. on a 2D regular raster.
5488+
5489+ The input may either be actual RGB(A) data, or 2D scalar data, which
5490+ will be rendered as a pseudocolor image. Note: For actually displaying
5491+ a grayscale image set up the color mapping using the parameters
5492+ ``cmap='gray', vmin=0, vmax=255``.
54885493
54895494 Parameters
54905495 ----------
54915496 X : array-like or PIL image
54925497 The image data. Supported array shapes are:
54935498
5494- - (M, N): an image with scalar data. The data is visualized
5495- using a colormap.
5499+ - (M, N): an image with scalar data. The values are mapped to
5500+ colors using normalization and a colormap. See parameters *norm*,
5501+ *cmap*, *vmin*, *vmax*.
54965502 - (M, N, 3): an image with RGB values (0-1 float or 0-255 int).
54975503 - (M, N, 4): an image with RGBA values (0-1 float or 0-255 int),
54985504 i.e. including transparency.