@header@
 
 
matplotlib.image
index
/home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/image.py

The image module supports basic image loading, rescaling and display
operations.

 
Modules
       
matplotlib._image
matplotlib.cm
numpy.ma
matplotlib.artist
matplotlib.colors
numpy
os
warnings

 
Classes
       
matplotlib.artist.Artist(__builtin__.object)
AxesImage(matplotlib.artist.Artist, matplotlib.cm.ScalarMappable)
NonUniformImage
FigureImage(matplotlib.artist.Artist, matplotlib.cm.ScalarMappable)
PcolorImage(matplotlib.artist.Artist, matplotlib.cm.ScalarMappable)
matplotlib.cm.ScalarMappable
AxesImage(matplotlib.artist.Artist, matplotlib.cm.ScalarMappable)
NonUniformImage
FigureImage(matplotlib.artist.Artist, matplotlib.cm.ScalarMappable)
PcolorImage(matplotlib.artist.Artist, matplotlib.cm.ScalarMappable)

 
class AxesImage(matplotlib.artist.Artist, matplotlib.cm.ScalarMappable)
    
Method resolution order:
AxesImage
matplotlib.artist.Artist
__builtin__.object
matplotlib.cm.ScalarMappable

Methods defined here:
__init__(self, ax, cmap=None, norm=None, interpolation=None, origin=None, extent=None, filternorm=1, filterrad=4.0, **kwargs)
interpolation and cmap default to their rc settings
 
cmap is a colors.Colormap instance
norm is a colors.Normalize instance to map luminance to 0-1
 
extent is data axes (left, right, bottom, top) for making image plots
registered with data plots.  Default is to label the pixel
centers with the zero-based row and column indices.
 
Additional kwargs are matplotlib.artist properties
changed(self)
Call this whenever the mappable is changed so observers can
update state
contains(self, mouseevent)
Test whether the mouse event occured within the image.
draw(self, renderer, *args, **kwargs)
get_extent(self)
get the image extent: left, right, bottom, top
get_filternorm(self)
return the filternorm setting
get_filterrad(self)
return the filterrad setting
get_interpolation(self)
Return the interpolation method the image uses when resizing.
 
One of
 
'bicubic', 'bilinear', 'blackman100', 'blackman256', 'blackman64',
'nearest', 'sinc144', 'sinc256', 'sinc64', 'spline16', 'spline36'
get_size(self)
Get the numrows, numcols of the input image
make_image(self, magnification=1.0)
set_alpha(self, alpha)
Set the alpha value used for blending - not supported on
all backends
 
ACCEPTS: float
set_array(self, A)
retained for backwards compatibility - use set_data instead
 
ACCEPTS: numpy array A or PIL Image
set_data(self, A, shape=None)
Set the image array
 
ACCEPTS: numpy/PIL Image A
set_extent(self, extent)
extent is data axes (left, right, bottom, top) for making image plots
set_filternorm(self, filternorm)
Set whether the resize filter norms the weights -- see
help for imshow
 
ACCEPTS: 0 or 1
set_filterrad(self, filterrad)
Set the resize filter radius only applicable to some
interpolation schemes -- see help for imshow
 
ACCEPTS: positive float
set_interpolation(self, s)
Set the interpolation method the image uses when resizing.
 
ACCEPTS: ['bicubic' | 'bilinear' | 'blackman100' | 'blackman256' | 'blackman64', 'nearest' | 'sinc144' | 'sinc256' | 'sinc64' | 'spline16' | 'spline36']
write_png(self, fname, noscale=False)
Write the image to png file with fname

Data and other attributes defined here:
interpnames = ['bilinear', 'nearest', 'kaiser', 'quadric', 'hermite', 'blackman', 'catrom', 'gaussian', 'hanning', 'spline36', 'hamming', 'lanczos', 'bicubic', 'mitchell', 'bessel', 'sinc', 'spline16']
k = 'spline16'
v = 3
zorder = 1

Methods inherited from matplotlib.artist.Artist:
add_callback(self, func)
convert_xunits(self, x)
for artists in an axes, if the xaxis as units support,
convert x using xaxis unit type
convert_yunits(self, y)
for artists in an axes, if the yaxis as units support,
convert y using yaxis unit type
get_alpha(self)
Return the alpha value used for blending - not supported on all
backends
get_animated(self)
return the artist's animated state
get_axes(self)
return the axes instance the artist resides in, or None
get_clip_box(self)
Return artist clipbox
get_clip_on(self)
Return whether artist uses clipping
get_clip_path(self)
Return artist clip path
get_contains(self)
return the _contains test used by the artist, or None for default.
get_figure(self)
return the figure instance
get_label(self)
get_picker(self)
return the Pickeration instance used by this artist
get_transform(self)
return the Transformation instance used by this artist
get_transformed_clip_path_and_affine(self)
Return the clip path with the non-affine part of its transformation applied,
and the remaining affine part of its transformation.
get_visible(self)
return the artist's visiblity
get_zorder(self)
have_units(self)
return True if units are set on the x or y axes
hitlist(self, event)
List the children of the artist which contain the mouse event
is_figure_set(self)
is_transform_set(self)
Artist has transform explicity let
pchanged(self)
fire event when property changed
pick(self, mouseevent)
pick(mouseevent)
 
each child artist will fire a pick event if mouseevent is over
the artist and the artist has picker set
pickable(self)
return True if self is pickable
remove(self)
Remove the artist from the figure if possible.  The effect will not
be visible until the figure is redrawn, e.g., with ax.draw_idle().
Call ax.relim() to update the axes limits if desired.
 
Note: relim() will not see collections even if the collection
was added to axes with autolim=True.
 
Note: there is no support for removing the artist's legend entry.
remove_callback(self, oid)
set(self, **kwargs)
A tkstyle set command, pass kwargs to set properties
set_animated(self, b)
set the artist's animation state
 
ACCEPTS: [True | False]
set_axes(self, axes)
set the axes instance the artist resides in, if any
 
ACCEPTS: an axes instance
set_clip_box(self, clipbox)
Set the artist's clip Bbox
 
ACCEPTS: a matplotlib.transform.Bbox instance
set_clip_on(self, b)
Set  whether artist uses clipping
 
ACCEPTS: [True | False]
set_clip_path(self, path, transform=None)
Set the artist's clip path, which may be:
 
  a) a Patch (or subclass) instance
 
  b) a Path instance, in which cas aoptional transform may
     be provided, which will be applied to the path before using it
     for clipping.
 
  c) None, to remove the clipping path
 
For efficiency, if the path happens to be an axis-aligned
rectangle, this method will set the clipping box to the
corresponding rectangle and set the clipping path to None.
 
ACCEPTS: a Path instance and a Transform instance, a Patch
instance, or None
set_contains(self, picker)
Replace the contains test used by this artist. The new picker should
be a callable function which determines whether the artist is hit by the
mouse event:
 
    hit, props = picker(artist, mouseevent)
 
If the mouse event is over the artist, return hit=True and props
is a dictionary of properties you want returned with the contains test.
set_figure(self, fig)
Set the figure instance the artist belong to
 
ACCEPTS: a matplotlib.figure.Figure instance
set_label(self, s)
Set the line label to s for auto legend
 
ACCEPTS: any string
set_lod(self, on)
Set Level of Detail on or off.  If on, the artists may examine
things like the pixel width of the axes and draw a subset of
their contents accordingly
 
ACCEPTS: [True | False]
set_picker(self, picker)
set the epsilon for picking used by this artist
 
picker can be one of the following:
 
  None -  picking is disabled for this artist (default)
 
  boolean - if True then picking will be enabled and the
    artist will fire a pick event if the mouse event is over
    the artist
 
  float - if picker is a number it is interpreted as an
    epsilon tolerance in points and the the artist will fire
    off an event if it's data is within epsilon of the mouse
    event.  For some artists like lines and patch collections,
    the artist may provide additional data to the pick event
    that is generated, eg the indices of the data within
    epsilon of the pick event
 
  function - if picker is callable, it is a user supplied
    function which determines whether the artist is hit by the
    mouse event.
 
      hit, props = picker(artist, mouseevent)
 
    to determine the hit test.  if the mouse event is over the
    artist, return hit=True and props is a dictionary of
    properties you want added to the PickEvent attributes
 
ACCEPTS: [None|float|boolean|callable]
set_transform(self, t)
set the Transformation instance used by this artist
 
ACCEPTS: a matplotlib.transform transformation instance
set_visible(self, b)
set the artist's visiblity
 
ACCEPTS: [True | False]
set_zorder(self, level)
Set the zorder for the artist
 
ACCEPTS: any number
update(self, props)
update_from(self, other)
copy properties from other to self

Data descriptors inherited from matplotlib.artist.Artist:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)

Data and other attributes inherited from matplotlib.artist.Artist:
aname = 'Artist'

Methods inherited from matplotlib.cm.ScalarMappable:
add_checker(self, checker)
Add an entry to a dictionary of boolean flags
that are set to True when the mappable is changed.
autoscale(self)
Autoscale the scalar limits on the norm instance using the
current array
autoscale_None(self)
Autoscale the scalar limits on the norm instance using the
current array, changing only limits that are None
check_update(self, checker)
If mappable has changed since the last check,
return True; else return False
get_array(self)
Return the array
get_clim(self)
return the min, max of the color limits for image scaling
get_cmap(self)
return the colormap
set_clim(self, vmin=None, vmax=None)
set the norm limits for image scaling; if vmin is a length2
sequence, interpret it as (vmin, vmax) which is used to
support setp
 
ACCEPTS: a length 2 sequence of floats
set_cmap(self, cmap)
set the colormap for luminance data
 
ACCEPTS: a colormap
set_colorbar(self, im, ax)
set the colorbar image and axes associated with mappable
set_norm(self, norm)
set the normalization instance
to_rgba(self, x, alpha=1.0, bytes=False)
Return a normalized rgba array corresponding to x.
If x is already an rgb array, insert alpha; if it is
already rgba, return it unchanged.
If bytes is True, return rgba as 4 uint8s instead of 4 floats.

 
class FigureImage(matplotlib.artist.Artist, matplotlib.cm.ScalarMappable)
    
Method resolution order:
FigureImage
matplotlib.artist.Artist
__builtin__.object
matplotlib.cm.ScalarMappable

Methods defined here:
__init__(self, fig, cmap=None, norm=None, offsetx=0, offsety=0, origin=None, **kwargs)
cmap is a colors.Colormap instance
norm is a colors.Normalize instance to map luminance to 0-1
 
kwargs are an optional list of Artist keyword args
contains(self, mouseevent)
Test whether the mouse event occured within the image.
draw(self, renderer, *args, **kwargs)
get_extent(self)
get the image extent: left, right, bottom, top
get_size(self)
Get the numrows, numcols of the input image
make_image(self, magnification=1.0)
write_png(self, fname)
Write the image to png file with fname

Data and other attributes defined here:
zorder = 1

Methods inherited from matplotlib.artist.Artist:
add_callback(self, func)
convert_xunits(self, x)
for artists in an axes, if the xaxis as units support,
convert x using xaxis unit type
convert_yunits(self, y)
for artists in an axes, if the yaxis as units support,
convert y using yaxis unit type
get_alpha(self)
Return the alpha value used for blending - not supported on all
backends
get_animated(self)
return the artist's animated state
get_axes(self)
return the axes instance the artist resides in, or None
get_clip_box(self)
Return artist clipbox
get_clip_on(self)
Return whether artist uses clipping
get_clip_path(self)
Return artist clip path
get_contains(self)
return the _contains test used by the artist, or None for default.
get_figure(self)
return the figure instance
get_label(self)
get_picker(self)
return the Pickeration instance used by this artist
get_transform(self)
return the Transformation instance used by this artist
get_transformed_clip_path_and_affine(self)
Return the clip path with the non-affine part of its transformation applied,
and the remaining affine part of its transformation.
get_visible(self)
return the artist's visiblity
get_zorder(self)
have_units(self)
return True if units are set on the x or y axes
hitlist(self, event)
List the children of the artist which contain the mouse event
is_figure_set(self)
is_transform_set(self)
Artist has transform explicity let
pchanged(self)
fire event when property changed
pick(self, mouseevent)
pick(mouseevent)
 
each child artist will fire a pick event if mouseevent is over
the artist and the artist has picker set
pickable(self)
return True if self is pickable
remove(self)
Remove the artist from the figure if possible.  The effect will not
be visible until the figure is redrawn, e.g., with ax.draw_idle().
Call ax.relim() to update the axes limits if desired.
 
Note: relim() will not see collections even if the collection
was added to axes with autolim=True.
 
Note: there is no support for removing the artist's legend entry.
remove_callback(self, oid)
set(self, **kwargs)
A tkstyle set command, pass kwargs to set properties
set_alpha(self, alpha)
Set the alpha value used for blending - not supported on
all backends
 
ACCEPTS: float
set_animated(self, b)
set the artist's animation state
 
ACCEPTS: [True | False]
set_axes(self, axes)
set the axes instance the artist resides in, if any
 
ACCEPTS: an axes instance
set_clip_box(self, clipbox)
Set the artist's clip Bbox
 
ACCEPTS: a matplotlib.transform.Bbox instance
set_clip_on(self, b)
Set  whether artist uses clipping
 
ACCEPTS: [True | False]
set_clip_path(self, path, transform=None)
Set the artist's clip path, which may be:
 
  a) a Patch (or subclass) instance
 
  b) a Path instance, in which cas aoptional transform may
     be provided, which will be applied to the path before using it
     for clipping.
 
  c) None, to remove the clipping path
 
For efficiency, if the path happens to be an axis-aligned
rectangle, this method will set the clipping box to the
corresponding rectangle and set the clipping path to None.
 
ACCEPTS: a Path instance and a Transform instance, a Patch
instance, or None
set_contains(self, picker)
Replace the contains test used by this artist. The new picker should
be a callable function which determines whether the artist is hit by the
mouse event:
 
    hit, props = picker(artist, mouseevent)
 
If the mouse event is over the artist, return hit=True and props
is a dictionary of properties you want returned with the contains test.
set_figure(self, fig)
Set the figure instance the artist belong to
 
ACCEPTS: a matplotlib.figure.Figure instance
set_label(self, s)
Set the line label to s for auto legend
 
ACCEPTS: any string
set_lod(self, on)
Set Level of Detail on or off.  If on, the artists may examine
things like the pixel width of the axes and draw a subset of
their contents accordingly
 
ACCEPTS: [True | False]
set_picker(self, picker)
set the epsilon for picking used by this artist
 
picker can be one of the following:
 
  None -  picking is disabled for this artist (default)
 
  boolean - if True then picking will be enabled and the
    artist will fire a pick event if the mouse event is over
    the artist
 
  float - if picker is a number it is interpreted as an
    epsilon tolerance in points and the the artist will fire
    off an event if it's data is within epsilon of the mouse
    event.  For some artists like lines and patch collections,
    the artist may provide additional data to the pick event
    that is generated, eg the indices of the data within
    epsilon of the pick event
 
  function - if picker is callable, it is a user supplied
    function which determines whether the artist is hit by the
    mouse event.
 
      hit, props = picker(artist, mouseevent)
 
    to determine the hit test.  if the mouse event is over the
    artist, return hit=True and props is a dictionary of
    properties you want added to the PickEvent attributes
 
ACCEPTS: [None|float|boolean|callable]
set_transform(self, t)
set the Transformation instance used by this artist
 
ACCEPTS: a matplotlib.transform transformation instance
set_visible(self, b)
set the artist's visiblity
 
ACCEPTS: [True | False]
set_zorder(self, level)
Set the zorder for the artist
 
ACCEPTS: any number
update(self, props)
update_from(self, other)
copy properties from other to self

Data descriptors inherited from matplotlib.artist.Artist:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)

Data and other attributes inherited from matplotlib.artist.Artist:
aname = 'Artist'

Methods inherited from matplotlib.cm.ScalarMappable:
add_checker(self, checker)
Add an entry to a dictionary of boolean flags
that are set to True when the mappable is changed.
autoscale(self)
Autoscale the scalar limits on the norm instance using the
current array
autoscale_None(self)
Autoscale the scalar limits on the norm instance using the
current array, changing only limits that are None
changed(self)
Call this whenever the mappable is changed to notify all the
callbackSM listeners to the 'changed' signal
check_update(self, checker)
If mappable has changed since the last check,
return True; else return False
get_array(self)
Return the array
get_clim(self)
return the min, max of the color limits for image scaling
get_cmap(self)
return the colormap
set_array(self, A)
Set the image array from numpy array A
set_clim(self, vmin=None, vmax=None)
set the norm limits for image scaling; if vmin is a length2
sequence, interpret it as (vmin, vmax) which is used to
support setp
 
ACCEPTS: a length 2 sequence of floats
set_cmap(self, cmap)
set the colormap for luminance data
 
ACCEPTS: a colormap
set_colorbar(self, im, ax)
set the colorbar image and axes associated with mappable
set_norm(self, norm)
set the normalization instance
to_rgba(self, x, alpha=1.0, bytes=False)
Return a normalized rgba array corresponding to x.
If x is already an rgb array, insert alpha; if it is
already rgba, return it unchanged.
If bytes is True, return rgba as 4 uint8s instead of 4 floats.

 
class NonUniformImage(AxesImage)
    
Method resolution order:
NonUniformImage
AxesImage
matplotlib.artist.Artist
__builtin__.object
matplotlib.cm.ScalarMappable

Methods defined here:
__init__(self, ax, **kwargs)
get_extent(self)
make_image(self, magnification=1.0)
set_array(self, *args)
set_cmap(self, cmap)
set_data(self, x, y, A)
set_filternorm(self, s)
set_filterrad(self, s)
set_interpolation(self, s)
set_norm(self, norm)

Methods inherited from AxesImage:
changed(self)
Call this whenever the mappable is changed so observers can
update state
contains(self, mouseevent)
Test whether the mouse event occured within the image.
draw(self, renderer, *args, **kwargs)
get_filternorm(self)
return the filternorm setting
get_filterrad(self)
return the filterrad setting
get_interpolation(self)
Return the interpolation method the image uses when resizing.
 
One of
 
'bicubic', 'bilinear', 'blackman100', 'blackman256', 'blackman64',
'nearest', 'sinc144', 'sinc256', 'sinc64', 'spline16', 'spline36'
get_size(self)
Get the numrows, numcols of the input image
set_alpha(self, alpha)
Set the alpha value used for blending - not supported on
all backends
 
ACCEPTS: float
set_extent(self, extent)
extent is data axes (left, right, bottom, top) for making image plots
write_png(self, fname, noscale=False)
Write the image to png file with fname

Data and other attributes inherited from AxesImage:
interpnames = ['bilinear', 'nearest', 'kaiser', 'quadric', 'hermite', 'blackman', 'catrom', 'gaussian', 'hanning', 'spline36', 'hamming', 'lanczos', 'bicubic', 'mitchell', 'bessel', 'sinc', 'spline16']
k = 'spline16'
v = 3
zorder = 1

Methods inherited from matplotlib.artist.Artist:
add_callback(self, func)
convert_xunits(self, x)
for artists in an axes, if the xaxis as units support,
convert x using xaxis unit type
convert_yunits(self, y)
for artists in an axes, if the yaxis as units support,
convert y using yaxis unit type
get_alpha(self)
Return the alpha value used for blending - not supported on all
backends
get_animated(self)
return the artist's animated state
get_axes(self)
return the axes instance the artist resides in, or None
get_clip_box(self)
Return artist clipbox
get_clip_on(self)
Return whether artist uses clipping
get_clip_path(self)
Return artist clip path
get_contains(self)
return the _contains test used by the artist, or None for default.
get_figure(self)
return the figure instance
get_label(self)
get_picker(self)
return the Pickeration instance used by this artist
get_transform(self)
return the Transformation instance used by this artist
get_transformed_clip_path_and_affine(self)
Return the clip path with the non-affine part of its transformation applied,
and the remaining affine part of its transformation.
get_visible(self)
return the artist's visiblity
get_zorder(self)
have_units(self)
return True if units are set on the x or y axes
hitlist(self, event)
List the children of the artist which contain the mouse event
is_figure_set(self)
is_transform_set(self)
Artist has transform explicity let
pchanged(self)
fire event when property changed
pick(self, mouseevent)
pick(mouseevent)
 
each child artist will fire a pick event if mouseevent is over
the artist and the artist has picker set
pickable(self)
return True if self is pickable
remove(self)
Remove the artist from the figure if possible.  The effect will not
be visible until the figure is redrawn, e.g., with ax.draw_idle().
Call ax.relim() to update the axes limits if desired.
 
Note: relim() will not see collections even if the collection
was added to axes with autolim=True.
 
Note: there is no support for removing the artist's legend entry.
remove_callback(self, oid)
set(self, **kwargs)
A tkstyle set command, pass kwargs to set properties
set_animated(self, b)
set the artist's animation state
 
ACCEPTS: [True | False]
set_axes(self, axes)
set the axes instance the artist resides in, if any
 
ACCEPTS: an axes instance
set_clip_box(self, clipbox)
Set the artist's clip Bbox
 
ACCEPTS: a matplotlib.transform.Bbox instance
set_clip_on(self, b)
Set  whether artist uses clipping
 
ACCEPTS: [True | False]
set_clip_path(self, path, transform=None)
Set the artist's clip path, which may be:
 
  a) a Patch (or subclass) instance
 
  b) a Path instance, in which cas aoptional transform may
     be provided, which will be applied to the path before using it
     for clipping.
 
  c) None, to remove the clipping path
 
For efficiency, if the path happens to be an axis-aligned
rectangle, this method will set the clipping box to the
corresponding rectangle and set the clipping path to None.
 
ACCEPTS: a Path instance and a Transform instance, a Patch
instance, or None
set_contains(self, picker)
Replace the contains test used by this artist. The new picker should
be a callable function which determines whether the artist is hit by the
mouse event:
 
    hit, props = picker(artist, mouseevent)
 
If the mouse event is over the artist, return hit=True and props
is a dictionary of properties you want returned with the contains test.
set_figure(self, fig)
Set the figure instance the artist belong to
 
ACCEPTS: a matplotlib.figure.Figure instance
set_label(self, s)
Set the line label to s for auto legend
 
ACCEPTS: any string
set_lod(self, on)
Set Level of Detail on or off.  If on, the artists may examine
things like the pixel width of the axes and draw a subset of
their contents accordingly
 
ACCEPTS: [True | False]
set_picker(self, picker)
set the epsilon for picking used by this artist
 
picker can be one of the following:
 
  None -  picking is disabled for this artist (default)
 
  boolean - if True then picking will be enabled and the
    artist will fire a pick event if the mouse event is over
    the artist
 
  float - if picker is a number it is interpreted as an
    epsilon tolerance in points and the the artist will fire
    off an event if it's data is within epsilon of the mouse
    event.  For some artists like lines and patch collections,
    the artist may provide additional data to the pick event
    that is generated, eg the indices of the data within
    epsilon of the pick event
 
  function - if picker is callable, it is a user supplied
    function which determines whether the artist is hit by the
    mouse event.
 
      hit, props = picker(artist, mouseevent)
 
    to determine the hit test.  if the mouse event is over the
    artist, return hit=True and props is a dictionary of
    properties you want added to the PickEvent attributes
 
ACCEPTS: [None|float|boolean|callable]
set_transform(self, t)
set the Transformation instance used by this artist
 
ACCEPTS: a matplotlib.transform transformation instance
set_visible(self, b)
set the artist's visiblity
 
ACCEPTS: [True | False]
set_zorder(self, level)
Set the zorder for the artist
 
ACCEPTS: any number
update(self, props)
update_from(self, other)
copy properties from other to self

Data descriptors inherited from matplotlib.artist.Artist:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)

Data and other attributes inherited from matplotlib.artist.Artist:
aname = 'Artist'

Methods inherited from matplotlib.cm.ScalarMappable:
add_checker(self, checker)
Add an entry to a dictionary of boolean flags
that are set to True when the mappable is changed.
autoscale(self)
Autoscale the scalar limits on the norm instance using the
current array
autoscale_None(self)
Autoscale the scalar limits on the norm instance using the
current array, changing only limits that are None
check_update(self, checker)
If mappable has changed since the last check,
return True; else return False
get_array(self)
Return the array
get_clim(self)
return the min, max of the color limits for image scaling
get_cmap(self)
return the colormap
set_clim(self, vmin=None, vmax=None)
set the norm limits for image scaling; if vmin is a length2
sequence, interpret it as (vmin, vmax) which is used to
support setp
 
ACCEPTS: a length 2 sequence of floats
set_colorbar(self, im, ax)
set the colorbar image and axes associated with mappable
to_rgba(self, x, alpha=1.0, bytes=False)
Return a normalized rgba array corresponding to x.
If x is already an rgb array, insert alpha; if it is
already rgba, return it unchanged.
If bytes is True, return rgba as 4 uint8s instead of 4 floats.

 
class PcolorImage(matplotlib.artist.Artist, matplotlib.cm.ScalarMappable)
    Make a pcolor-style plot with an irregular rectangular grid.
 
This uses a variation of the original irregular image code,
and it is used by pcolorfast for the corresponding grid type.
 
 
Method resolution order:
PcolorImage
matplotlib.artist.Artist
__builtin__.object
matplotlib.cm.ScalarMappable

Methods defined here:
__init__(self, ax, x=None, y=None, A=None, cmap=None, norm=None, **kwargs)
cmap defaults to its rc setting
 
cmap is a colors.Colormap instance
norm is a colors.Normalize instance to map luminance to 0-1
 
Additional kwargs are matplotlib.artist properties
draw(self, renderer, *args, **kwargs)
make_image(self, magnification=1.0)
set_alpha(self, alpha)
Set the alpha value used for blending - not supported on
all backends
 
ACCEPTS: float
set_array(self, *args)
set_data(self, x, y, A)

Methods inherited from matplotlib.artist.Artist:
add_callback(self, func)
contains(self, mouseevent)
Test whether the artist contains the mouse event.
 
Returns the truth value and a dictionary of artist specific details of
selection, such as which points are contained in the pick radius.  See
individual artists for details.
convert_xunits(self, x)
for artists in an axes, if the xaxis as units support,
convert x using xaxis unit type
convert_yunits(self, y)
for artists in an axes, if the yaxis as units support,
convert y using yaxis unit type
get_alpha(self)
Return the alpha value used for blending - not supported on all
backends
get_animated(self)
return the artist's animated state
get_axes(self)
return the axes instance the artist resides in, or None
get_clip_box(self)
Return artist clipbox
get_clip_on(self)
Return whether artist uses clipping
get_clip_path(self)
Return artist clip path
get_contains(self)
return the _contains test used by the artist, or None for default.
get_figure(self)
return the figure instance
get_label(self)
get_picker(self)
return the Pickeration instance used by this artist
get_transform(self)
return the Transformation instance used by this artist
get_transformed_clip_path_and_affine(self)
Return the clip path with the non-affine part of its transformation applied,
and the remaining affine part of its transformation.
get_visible(self)
return the artist's visiblity
get_zorder(self)
have_units(self)
return True if units are set on the x or y axes
hitlist(self, event)
List the children of the artist which contain the mouse event
is_figure_set(self)
is_transform_set(self)
Artist has transform explicity let
pchanged(self)
fire event when property changed
pick(self, mouseevent)
pick(mouseevent)
 
each child artist will fire a pick event if mouseevent is over
the artist and the artist has picker set
pickable(self)
return True if self is pickable
remove(self)
Remove the artist from the figure if possible.  The effect will not
be visible until the figure is redrawn, e.g., with ax.draw_idle().
Call ax.relim() to update the axes limits if desired.
 
Note: relim() will not see collections even if the collection
was added to axes with autolim=True.
 
Note: there is no support for removing the artist's legend entry.
remove_callback(self, oid)
set(self, **kwargs)
A tkstyle set command, pass kwargs to set properties
set_animated(self, b)
set the artist's animation state
 
ACCEPTS: [True | False]
set_axes(self, axes)
set the axes instance the artist resides in, if any
 
ACCEPTS: an axes instance
set_clip_box(self, clipbox)
Set the artist's clip Bbox
 
ACCEPTS: a matplotlib.transform.Bbox instance
set_clip_on(self, b)
Set  whether artist uses clipping
 
ACCEPTS: [True | False]
set_clip_path(self, path, transform=None)
Set the artist's clip path, which may be:
 
  a) a Patch (or subclass) instance
 
  b) a Path instance, in which cas aoptional transform may
     be provided, which will be applied to the path before using it
     for clipping.
 
  c) None, to remove the clipping path
 
For efficiency, if the path happens to be an axis-aligned
rectangle, this method will set the clipping box to the
corresponding rectangle and set the clipping path to None.
 
ACCEPTS: a Path instance and a Transform instance, a Patch
instance, or None
set_contains(self, picker)
Replace the contains test used by this artist. The new picker should
be a callable function which determines whether the artist is hit by the
mouse event:
 
    hit, props = picker(artist, mouseevent)
 
If the mouse event is over the artist, return hit=True and props
is a dictionary of properties you want returned with the contains test.
set_figure(self, fig)
Set the figure instance the artist belong to
 
ACCEPTS: a matplotlib.figure.Figure instance
set_label(self, s)
Set the line label to s for auto legend
 
ACCEPTS: any string
set_lod(self, on)
Set Level of Detail on or off.  If on, the artists may examine
things like the pixel width of the axes and draw a subset of
their contents accordingly
 
ACCEPTS: [True | False]
set_picker(self, picker)
set the epsilon for picking used by this artist
 
picker can be one of the following:
 
  None -  picking is disabled for this artist (default)
 
  boolean - if True then picking will be enabled and the
    artist will fire a pick event if the mouse event is over
    the artist
 
  float - if picker is a number it is interpreted as an
    epsilon tolerance in points and the the artist will fire
    off an event if it's data is within epsilon of the mouse
    event.  For some artists like lines and patch collections,
    the artist may provide additional data to the pick event
    that is generated, eg the indices of the data within
    epsilon of the pick event
 
  function - if picker is callable, it is a user supplied
    function which determines whether the artist is hit by the
    mouse event.
 
      hit, props = picker(artist, mouseevent)
 
    to determine the hit test.  if the mouse event is over the
    artist, return hit=True and props is a dictionary of
    properties you want added to the PickEvent attributes
 
ACCEPTS: [None|float|boolean|callable]
set_transform(self, t)
set the Transformation instance used by this artist
 
ACCEPTS: a matplotlib.transform transformation instance
set_visible(self, b)
set the artist's visiblity
 
ACCEPTS: [True | False]
set_zorder(self, level)
Set the zorder for the artist
 
ACCEPTS: any number
update(self, props)
update_from(self, other)
copy properties from other to self

Data descriptors inherited from matplotlib.artist.Artist:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)

Data and other attributes inherited from matplotlib.artist.Artist:
aname = 'Artist'
zorder = 0

Methods inherited from matplotlib.cm.ScalarMappable:
add_checker(self, checker)
Add an entry to a dictionary of boolean flags
that are set to True when the mappable is changed.
autoscale(self)
Autoscale the scalar limits on the norm instance using the
current array
autoscale_None(self)
Autoscale the scalar limits on the norm instance using the
current array, changing only limits that are None
changed(self)
Call this whenever the mappable is changed to notify all the
callbackSM listeners to the 'changed' signal
check_update(self, checker)
If mappable has changed since the last check,
return True; else return False
get_array(self)
Return the array
get_clim(self)
return the min, max of the color limits for image scaling
get_cmap(self)
return the colormap
set_clim(self, vmin=None, vmax=None)
set the norm limits for image scaling; if vmin is a length2
sequence, interpret it as (vmin, vmax) which is used to
support setp
 
ACCEPTS: a length 2 sequence of floats
set_cmap(self, cmap)
set the colormap for luminance data
 
ACCEPTS: a colormap
set_colorbar(self, im, ax)
set the colorbar image and axes associated with mappable
set_norm(self, norm)
set the normalization instance
to_rgba(self, x, alpha=1.0, bytes=False)
Return a normalized rgba array corresponding to x.
If x is already an rgb array, insert alpha; if it is
already rgba, return it unchanged.
If bytes is True, return rgba as 4 uint8s instead of 4 floats.

 
Functions
       
from_images(...)
from_images
fromarray(...)
fromarray
fromarray2(...)
fromarray2
frombuffer(...)
frombuffer
frombyte(...)
frombyte
imread(fname)
return image file in fname as numpy array
 
return value is a numpy array.  For grayscale images, the return
array is MxN.  For RGB images, the return value is MxNx3.  For
RGBA images the return value is MxNx4
 
matplotlib can only read PNGs natively, but if PIL is installed,
it will use it to load the image and return an array (if possible)
which can be used with imshow
 
TODO: support RGB and grayscale return values in _image.readpng
pcolor(...)
pcolor
pcolor2(...)
pcolor2
pil_to_array(pilImage)
load a PIL image and return it as a numpy array of uint8.  For
grayscale images, the return array is MxN.  For RGB images, the
return value is MxNx3.  For RGBA images the return value is MxNx4
readpng(...)
readpng

 
Data
        ASPECT_FREE = 1
ASPECT_PRESERVE = 0
BESSEL = 12
BICUBIC = 2
BILINEAR = 1
BLACKMAN = 16
CATROM = 10
GAUSSIAN = 11
HAMMING = 6
HANNING = 5
HERMITE = 7
KAISER = 8
LANCZOS = 15
MITCHELL = 13
NEAREST = 0
QUADRIC = 9
SINC = 14
SPLINE16 = 3
SPLINE36 = 4
division = _Feature((2, 2, 0, 'alpha', 2), (3, 0, 0, 'alpha', 0), 8192)
rcParams = {'figure.subplot.right': 0.90000000000000002, 'm...persize': 'letter', 'svg.embed_char_paths': True}
@footer@