Jc @ s d Z d d k l Z d d k Z d d k Z d d k Z d d k l Z d d k l Z d d k
i Z d d k
l
Z
d d k i Z d d k i Z d d k i Z d d k i Z d d k i Z d d k Td e i e i f d YZ d
e f d YZ d e i e i f d
YZ d e i e i f d YZ d Z e e e e e d Z! d Z" d d e# d Z$ d S( sS
The image module supports basic image loading, rescaling and display
operations.
i( t divisionN( t ma( t rcParams( t allow_rasterization( t *t AxesImagec B s e Z d Z h e i d 6e i d 6e i d 6e i d 6e i d 6e i d 6e i
d 6e i d 6e i d 6e i
d
6e i d 6e i d 6e i d
6e i d 6e i d 6e i d 6e i d 6Z e g Z e i D] \ Z Z e e e f q [ Z e i Z d Z d) d) d) d) d) d d e d Z! d Z" d Z# d Z$ d d Z% e& d Z' d Z( e d Z) d Z* d Z+ d Z, d Z- d! Z. d" Z/ d# Z0 d$ Z1 d% Z2 d& Z3 d' Z4 d( Z5 RS(* i t nearestt bilineart bicubict spline16t spline36t hanningt hammingt hermitet kaisert quadrict catromt gaussiant besselt mitchellt sinct lanczost blackmanc C s d t | i i i S( Ns AxesImage(%g,%g;%gx%g)( t tuplet axest bboxt bounds( t self( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt __str__7 s g @c
K s t i i | t i i | | | | d j o t d } n | | _ | | _ | i | | i
| | | _ | i | | i
| | | _ d | _ | i |
d S( s
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
s image.originN( t martistt Artistt __init__t cmt ScalarMappablet NoneR t origint _extentt set_filternormt
set_filterradt
_filterradt set_interpolationt set_resampleR t _imcachet update( R t axt cmapt normt
interpolationR# t extentt
filternormt filterradt resamplet kwargs( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR : s
c C s. | i d j o t d n | i i d S( s+ Get the numrows, numcols of the input images" You must first set the image arrayi N( t _AR" t RuntimeErrort shape( R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt get_sizee s c C s t i i | | d | _ d S( sw
Set the alpha value used for blending - not supported on
all backends
ACCEPTS: float
N( R R t set_alphaR" R* ( R t alpha( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR9 l s c C s& d | _ d | _ t i i | d S( sb
Call this whenever the mappable is changed so observers can
update state
N( R" R* t
_rgbacacheR R! t changed( R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR< v s g ?c & C s | i d j o t d n | i \ } } } } | | } | | } | | i i i } | | i i i } | i i d \ }
} | d j o | i i i | | | } t
d t | | i }
| i i i
| | | } t | t | | i } t |
| } | } | |
| | } | | | | } | | } | | i i i } n t d | } | d j o | i i i | | |
} t
d t | | i } | i i i | | |
} t |
t | | i } | i d j o t |
| |
| } n t | | } | } | | | |
} | | | |
} | | } | | i i i } n t d |
} | | i j p | | i j o d | _ | | _ | | _ n | i d j o!| i i t i j oN t | i i d j o5 t i | i | | d d f d } t | _ n | i d j o% | i | i | i } | | _ n
| i } t i! | | | f d } t | i i d j o | i" i# | _ n
t | _ | | _ | i d j o | i$ qn
| i } | i i% i& } t' i( i | d } | i) | | i* | i+ \ }
} |
d j p
| d j o d S| i, | i- | i. | i/ | i0 | | i i i | | } | | i i i | |
} | i i1 i2 \ } } } }! t3 | d t3 | d }" t3 |! d t3 | d }# |" | 9}" |# | 9}# | i4 | | |" | }$ |# |
}% | i5 |$ | |% | | i6 t |" d t |# d d | i7 d | i | S(
Ns9 You must first set the image array or the image attributei i t upperi i g ?R. t radius(8 R5 R" R6 t
get_extentR t viewLimt widtht heightR7 t x0t maxt intR' t x1t mint slicet y0t y1R# t
_oldxslicet
_oldysliceR* t dtypet npt uint8t lent _imaget frombytet Falset is_grayscaleR; t to_rgbat _alphat fromarrayR- t is_grayt flipud_int patcht
get_facecolort mcolorst colorConvertert set_bgt reset_matrixR8 R( t _interpdt _interpolationR) t _resampleR t extentst roundt apply_translationt
apply_scalingt resizet _filternorm(& R t
magnificationt xmint xmaxt ymint ymaxt dxintvt dyintvt sxt syt numrowst numcolsRC t ix0RF t ix1t xslicet xmin_oldRI t iy0RJ t iy1t yslicet ymin_oldt imt xt fct bgt txt tyt lt bt rt tt widthDisplayt
heightDisplayt rxt ry( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt
make_image s
/(
#c O s | i p d S| i i d j p | i i d j o t i d n | i | i } | d j o d S| i | _
| i i i \ } } } } | i
\ } }
| i t | t | | | i i i | |
d S( Nt linears, Images are not supported on non-linear axes.( t get_visibleR t
get_xscalet
get_yscalet warningst warnR t get_image_magnificationR" t get_urlt _urlR R t$ get_transformed_clip_path_and_affinet
draw_imageRd t frozen( R t renderert argsR4 R| R R R R t clippatht affine( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt draw s
*c C s t | i o | i | | S| i | i } } | i \ } } } } | | j o | | } } n | | j o | | } } n | d j oD | d j o7 | | j o$ | | j o | | j o
| | j } n t } | h f S( sH
Test whether the mouse event occured within the image.
N( t callablet _containst xdatat ydataR? R" RS ( R t
mouseeventR} t yRj Rk Rl Rm t inside( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt contains s
7c C s | i } | d j o d S| o= | i \ } } | i | i d | i | | n | i | i \ } } } t i | | | | d S( s& Write the image to png file with fnameNi (
R R" R8 R_ R( Rg t
flipud_outt as_rgba_strt _pngt write_png( R t fnamet noscaleR| Rr Rs t rowst colst buffer( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR
s
c C s t | d o t | | _ n t i | | _ | i i t i j o- t i | i i t i o t
d n | i i d j p* | i i d j o' | i i d d
j o t
d n d | _ d | _ d | _ d | _ d S( sI
Set the image array
ACCEPTS: numpy/PIL Image A
t getpixels# Image data can not convert to floati i ii s! Invalid dimensions for image dataN( i i ( i i ( t hasattrt pil_to_arrayR5 t cbookt safe_masked_invalidRM RN RO t can_castt floatt TypeErrort ndimR7 R" R* R; RK RL ( R t A( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt set_data s 3* c C s | i | d S( sq
retained for backwards compatibility - use set_data instead
ACCEPTS: numpy array A or PIL ImageN( R ( R R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt set_array3 s c C s | | _ | \ } } } } | | f | | f f } | i i | | i i o | i i | | f n | i i o | i i | | f n d S( sW
extent is data axes (left, right, bottom, top) for making image plots
N( R$ R t update_datalimt
_autoscaleXont set_xlimt
_autoscaleYont set_ylim( R R0 Rj Rk Rl Rm t corners( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt
set_extent@ s
c C s | i S( s
Return the interpolation method the image uses when resizing.
One of 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning',
'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian',
'bessel', 'mitchell', 'sinc', 'lanczos',
( Ra ( R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt get_interpolationN s c C sT | d j o t d } n | i } | | i j o t d n | | _ d S( s?
Set the interpolation method the image uses when resizing.
ACCEPTS: ['nearest' | 'bilinear' | 'bicubic' | 'spline16' |
'spline36' | 'hanning' | 'hamming' | 'hermite' | 'kaiser' |
'quadric' | 'catrom' | 'gaussian' | 'bessel' | 'mitchell' |
'sinc' | 'lanczos' | ]
s image.interpolations Illegal interpolation stringN( R" R t lowerR` t
ValueErrorRa ( R t s( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR( X s
c C s( | d j o t d } n | | _ d S( sZ
set whether or not image resampling is used
ACCEPTS: True|False
s image.resampleN( R" R Rb ( R t v( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR) h s
c C s | i S( s! return the image resample boolean( Rb ( R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt get_resampleq s c C su | i d j o | i S| i } | \ } } | i d j o d | d | d d f Sd | d d | d f Sd S( s. get the image extent: left, right, bottom, topR= g g ?N( R$ R" R8 R# ( R t szRr Rs ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR? u s c C s! | o
d | _ n
d | _ d S( sy
Set whether the resize filter norms the weights -- see
help for imshow
ACCEPTS: 0 or 1
i i N( Rh ( R R1 ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR% s
c C s | i S( s return the filternorm setting( Rh ( R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt get_filternorm s c C s t | } | | _ d S( s
Set the resize filter radius only applicable to some
interpolation schemes -- see help for imshow
ACCEPTS: positive float
N( R R' ( R R2 R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR& s c C s | i S( s return the filterrad setting( R' ( R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt
get_filterrad s N(6 t __name__t
__module__t zorderRQ t NEARESTt BILINEARt BICUBICt SPLINE16t SPLINE36t HANNINGt HAMMINGt HERMITEt KAISERt QUADRICt CATROMt GAUSSIANt BESSELt MITCHELLt SINCt LANCZOSt BLACKMANR` t dictt _[1]t itemst kR t _interpdrt keyst interpnamesR R" RS R R8 R9 R< R R R R R R R R R R( R) R R? R% R R& R ( ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR sb
9 #
g
t NonUniformImagec B se e Z d Z d d Z d Z d Z d Z d Z d Z d Z d Z
d
Z RS( c K s9 | i d d } t i | | | t i | | d S( sx
kwargs are identical to those for AxesImage, except
that 'interpolation' defaults to 'nearest'
R/ R N( t popR R R( ( R R, R4 t interp( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR s g ?c C s2 | i d j o t d n | i i i \ } } } } | i i i \ } } } } t | d t | d }
t | d t | d } |
| 9}
| | 9} t i
| i | i | i | |
| | | | | | f | i
| i } | i i i }
t i i |
d } | i | | i | _ | S( Ns" You must first set the image arrayg ?i ( R5 R" R6 R R@ R R Rc Rd RQ t pcolort _Axt _AyR` Ra RZ R[ R\ R] RU R^ RT ( R Ri RC RI t v_widtht v_heightR R R R RA RB R| R~ R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR s"
c C s t i | t i } t i | t i } t i | } t | i d j pA t | i d j p+ | i d d !| i d | i d f j o t d n t | i d j o t d n t | i d j o$ | i d d j o t d n t | i d j o+ | i d d j o | i d d !| _ n t | i d j o | i t i j o> | i
| i | d i t i } | i
i
| _ qt i | d
d
d
d
t i f d d } d | d
d
d
d
d f ,+**(1
/%
c G s t d d S( Ns Method not supported( t NotImplementedError( R R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR s c C s> | d j o | d j o t d n t i | | d S( NR R s? Only nearest neighbor and bilinear interpolations are supported( s nearests bilinear( R" R R R( ( R R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR( s c C sL | i d j o t d n | i d | i d | i d | i d f S( Ns Must set data firsti i( R5 R" R6 R R ( R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR? s c C s d S( N( ( R R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR% s c C s d S( N( ( R R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR& s c C s7 | i d j o t d n t i i | | d S( Ns' Cannot change colors after loading data( R5 R" R6 R R! t set_norm( R R. ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR s c C s7 | i d j o t d n t i i | | d S( Ns' Cannot change colors after loading data( R5 R" R6 R R! t set_cmap( R R- ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR s ( R R R R R R R( R? R% R& R R ( ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR s
- t PcolorImagec B s\ e Z d Z d d d d d d Z d d Z e d Z d Z d Z d Z
RS( s
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.
c K s\ t i i | t i i | | | | | _ d | _ | i | | i | | | d S( s
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
N(
R R R R R! R R" R; R+ R ( R R, R} R R R- R. R4 ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR s
g ?c
C s | i d j o t d n | i i i } t i i | d } t i
| d i t i } | i i
i \ } } } } t | d t | d } t | d t | d } | | } | | } | i d oW | i | i d | i d t }
|
| _ | i i d j o | i i | _ qAn
| i }
| i i } t i | i | i |
| | | i | i | i | i f | } | i | _ | S( Ns" You must first set the image arrayi i g ?t arrayR: t bytesi (! R5 R" R6 R RZ R[ R\ R] RU RN R R RO R Rc Rd t check_updateRV R R; R R- RX RT R@ RQ t pcolor2R R RC RF RI RJ (
R Ri R~ R R R R R RA RB R t vlR| ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR * s0
! c O st | i p d S| i | i } | i t | i i i t | i i i | | i i i | i
d S( N( R R R R Rd R R Rj Rl R R ( R R R R4 R| ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR E s
c C s_ t i | } | d j o* t i d | i d d d t i } n t i | t i i } | d j o* t i d | i d d d t i } n t i | t i i } | i d | i d | i d f j o( | i GH| i GH| i GHt
d n | i d j o t
d n | i d j o( | i d d j o | i d | _ n t | _
| i d j o | i d d j o | d d d d d f | d d d d d f j i oR | d d d d d f | d d d d d f j i o
t | _
q/q3t
d n | | _ | | _ | | _ t | i d
`_ is installed, it will
use it to load the image and return an array (if possible) which
can be used with :func:`~matplotlib.pyplot.imshow`.
c s@ y d d k } Wn t j
o d SX| i } t | S( s- try to load the image with PIL or return NoneiN( t Imaget ImportErrorR" t openR ( R t image( R ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt pilread s t pngi s\ Only know how to handle extensions: %s; with PIL installed matplotlib can handle more imagesN( R t read_pngt ost patht splitextR R R" R ( R R t handlerst basenamet extR| t handler( ( R s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt imread s
c C s d d k l } d d k l } | d | i d d d d d d t } | | }
| i | d | d
| d | d | | i | d d d
| d S( s
Saves a 2D :class:`numpy.array` as an image with one pixel per element.
The output formats available depend on the backend being used.
Arguments:
*fname*:
A string containing a path to a filename, or a Python file-like object.
If *format* is *None* and *fname* is a string, the output
format is deduced from the extension of the filename.
*arr*:
A 2D array.
Keyword arguments:
*vmin*/*vmax*: [ None | scalar ]
*vmin* and *vmax* set the color scaling for the image by fixing the
values that map to the colormap color limits. If either *vmin* or *vmax*
is None, that limit is determined from the *arr* min/max value.
*cmap*:
cmap is a colors.Colormap instance, eg cm.jet.
If None, default to the rc image.cmap value.
*format*:
One of the file extensions supported by the active
backend. Most backends support png, pdf, ps, eps and svg.
*origin*
[ 'upper' | 'lower' ] Indicates where the [0,0] index of
the array is in the upper left or lower left corner of
the axes. Defaults to the rc image.origin value.
i( t FigureCanvasAgg( t Figuret figsizeNt dpii t frameonR- t vmint vmaxR# t format( t matplotlib.backends.backend_aggR t matplotlib.figureR R7 RS t figimaget savefig( R t arrR$ R% R- R& R# t FigureCanvasR R t canvas( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt imsave s + %c C s d } | i d j o
| } n | i d j o4 | } | | } | i d | i d f | _ | S| i d j o7 | } | | } | i d | i d d f | _ | Sy | i d } Wn t j
o t d n X| | } | i d | i d d
f | _ | S( s
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
c S s4 | i d | i d d } t i | t i } | S( s return a 1D array of floatst rawi i( t tostringt modeRN t
fromstringRO ( R| t x_strR} ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt toarray< s t RGBAt RGBXt Li i t RGBi s Unknown image modei ( R5 R6 ( R1 R R7 t convertR R6 ( t pilImageR4 R| R} ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyR 6 s(
g?R c C s t i i | \ } } t i i | \ } } t | } | i \ }
} } d }
t |
|
| } t | |
| } | i } | o1 d d k i } | i
d | | f d |
} n | d j o d d k l } nO | d j o d d k
l } n. | d
j o d d k l } n
t d d d
k l } | d | | f d |
} | | } | i d d d d g d d d t d g d g } t i i | \ } } | i | d d d t d d | i | d |
| S( s
make a thumbnail of image in *infile* with output filename
*thumbfile*.
*infile* the image file -- must be PNG or PIL readable if you
have `PIL `_ installed
*thumbfile*
the thumbnail filename
*scale*
the scale factor for the thumbnail
*interpolation*
the interpolation scheme used in the resampling
*preview*
if True, the default backend (presumably a user interface
backend) will be used which will cause a figure to be raised
if :func:`~matplotlib.pyplot.show` is called. If it is False,
a pure image backend will be used depending on the extension,
'png'->FigureCanvasAgg, 'pdf'->FigureCanvasPDF,
'svg'->FigureCanvasSVG
See examples/misc/image_thumbnail.py.
.. htmlonly::
:ref:`misc-image_thumbnail`
Return value is the figure instance containing the thumbnail
id iNR! R" s .png( R s .pdf( t FigureCanvasPDFs .svg( t FigureCanvasSVGs0 Can only handle extensions 'png', 'svg' or 'pdf'( R i i t aspectt autoR# t xtickst yticksR3 R/ R ( R R t splitR R R7 R R t matplotlib.pyplott pyplotR R' R t matplotlib.backends.backend_pdfR; t matplotlib.backends.backend_svgR< R R( R t add_axesRS t imshowR R* ( t infilet thumbfilet scaleR/ t previewt basedirR t baseoutt extoutR| R R t depthR" RB RA t extensiont pltR R, R R- R, R ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt thumbnail\ s4 & "
3 (% R t
__future__R R R t numpyRN R t
matplotlibR t matplotlib.artistt artistR R t matplotlib.colorst colorsR\ t
matplotlib.cmR t matplotlib.cbookR t matplotlib._imageRQ t matplotlib._pngR R R! R R R R R R" R. R RS RR ( ( ( s6 /usr/lib64/python2.6/site-packages/matplotlib/image.pyt s.
i r o %% &