Rc@ sdZddlmZmZddlZddlZddlZddlZddlm Z ddl m Z ddl j Zddl mZddljZddljZddljZddljZddljZddlTddlmZmZmZddljZ d ej!ej"fd YZ#d e#fd YZ$d e$fdYZ%dej!ej"fdYZ&dej!ej"fdYZ'de#fdYZ(e)dZ*e)e)e)e)e)ddZ+dZ,dde-dZ.dS(sS The image module supports basic image loading, rescaling and display operations. i(tdivisiontprint_functionN(tma(trcParams(tallow_rasterization(t*(tBboxBasetBboxtIdentityTransformt_AxesImageBasecB seZdZiejd6ejd6ejd6ejd6ejd6ejd6ej d6ej d6ej d 6ej d 6ej d 6ejd 6ejd 6ejd6ejd6ejd6ejd6ejd6ZegejD]\ZZeef^qZejZdZd-d-d-d-ddedZ dZ!dZ"dZ#ddZ$dZ%e&dZ'dZ(dZ)e*d Z+d!Z,ed"Z-d#Z.d$Z/d%Z0d&Z1d'Z2d(Z3d)Z4d*Z5d+Z6d,Z7RS(.itnonetnearesttbilineartbicubictspline16tspline36thanningthammingthermitetkaisertquadrictcatromtgaussiantbesseltmitchelltsinctlanczostblackmancC sdt|jjjS(NsAxesImage(%g,%g;%gx%g)(ttupletaxestbboxtbounds(tself((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyt__str__>sig@c K stjj|tjj||||dkr?td}n||_|j||j |||_ |j ||j |||_ d|_d|_|j| dS(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(tmartisttArtistt__init__tcmtScalarMappabletNoneRtorigintset_filternormt set_filterradt _filterradtset_interpolationt set_resampleRt_imcachet_image_skew_coordinatetupdate( R taxtcmaptnormt interpolationR(t filternormt filterradtresampletkwargs((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR$As           cC s,|jdkrtdn|jjd S(s+Get the numrows, numcols of the input images"You must first set the image arrayiN(t_AR't RuntimeErrortshape(R ((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pytget_sizepscC s tjj||d|_dS(sw Set the alpha value used for blending - not supported on all backends ACCEPTS: float N(R"R#t set_alphaR'R.(R talpha((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR=wscC s&d|_d|_tjj|dS(sb Call this whenever the mappable is changed so observers can update state N(R'R.t _rgbacacheR%R&tchanged(R ((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR@s  g?cC stddS(Ns)The make_image method must be overridden.(R:(R t magnification((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyt make_imagescC sK|\}}}}||}||} |jdkrJ|dkrJd} n ||j} |jdkr{| dkr{d} n | |j} |jd \} } | dkr\|j||| }tdt||j}|j||| }t| t||j}t ||}|}|||| }|||| }||}||j} nt d| }| dkrU|j || | }tdt||j}|j || | }t| t||j}|j dkrt | || |}nt ||}|}||| | }||| | }||} | |j} nt d| }||j ks||jkrd|_||_ ||_n|jdkr)|jjtjkr |jjdkr tj|j||ddfd}t|_n|jdkr|j|jdt}tj||jrU|j}n|d ddfc|d dd f9<|d jtj}||_n |j}tj|||ddfd}|jjdkr|jj |_n t|_||_|j dkr2|j!q2n |j}||||| | | fS( s convert numpy array A with given extents ([x1, x2, y1, y2] in data coordinate) into the Image, given the viewlim (should be a bbox instance). Image will be clipped if the extents is significantly larger than the viewlim. gg?iitupperiNtbytes.ii("twidththeightR;tx0tmaxtintR+tx1tmintslicety0ty1R(t _oldxslicet _oldysliceR'R.R9tdtypetnptuint8tndimt_imagetfrombytetFalset is_grayscaleR?tto_rgbatmay_share_memorytcopytastypeR2tis_grayt flipud_in(R tAt image_extentstviewlimtxmintxmaxtymintymaxtdxintvtdyintvtsxtsytnumrowstnumcolsRGtix0RJtix1txslicetxmin_oldRMtiy0RNtiy1tyslicetymin_oldtimtx((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyt_get_unsampled_imagesz             '( ,  %   cC s,tj}|j| | |j||f\}}|j||f\} } d|| || tj| | g| |gg} | tj|g|ggj\} } | tj|gdggj\}}tjj| || |dd}||tjj||jj }|S(sh Retuen a transform that does (x1, y1) -> (x1, y1) (x2, y2) -> (x2, y2) (x2, y1) -> (x3, y3) It was intended to derive a skew transform that preserve the lower-left corner (x1, y1) and top-right corner(x2,y2), but change the the lower-right-corner(x2, y1) to a new position (x3, y3). g?i( t mtransformstAffine2Dt translatettransform_pointRRtmattflatt from_valuestinvertedt get_affine(RJRNtx2ty2tx3ty3ttr1tx2aty2atx3aty3atinv_mattatbtctdttr2ttr((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyt_get_rotate_and_skew_transforms 7((!%c+C s|j}|j\}}}}|jtj||f||fg}|d\} } |d\} } | | | | f} |jr|j\}}|jtj||fg}|d\}}|j| | | | ||}|}n t}|jj j \}}}}|j }|jtj||f||f||f||fg}t |dddft |dddf}}t |dddft |dddf}}tj||||}|j|j| |\} }!}"}#}$}%}&| dkr#dS|jjj}'tjj|'d}(| j|(| j| j\})}*| j|*|)|j| _|j| _|j ||!|"| |#|$|dS(su draw unsampled image. The renderer should support a draw_image method with scale parameter. iiN(!t get_transformt get_extentt transformRRtarrayR/RRRRtextentsR~RKRHRt from_extentsRvR9R'tpatcht get_facecolortmcolorstcolorConverterRYtset_bgt reset_matrixR<tresizetget_urlt_urltget_gidt_gidt draw_image(+R trenderertgcttranstx_llctx_trcty_llcty_trctxyt_xx1t_yy1t_xx2t_yy2t extent_in_ictx_lrcty_lrctxy2t_xx3t_yy3ttr_rotate_skewttrans_ic_to_canvasRJRNRRttrans_canvas_to_ictxy_tx1_tx2_ty1_ty2_t viewLim_in_icRtRbRdRfRgRhRitfctbgRjRk((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyt_draw_unsampled_imagesL  !       99-   cC stS(s{ return True if the image is better to be drawn unsampled. The derived class needs to override it. (RW(R R((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyt_check_unsampled_imagePsc O sX|jsdS|jjdks:|jjdkrJtjdn|jjj\}}}}|j}|j |jjj |j |j |j |j|j|r|j||nx|jdk rtjdn|j|j} | dkrdS|j| _|j| _|j|||| |jdS(Ntlinears,Images are not supported on non-linear axes.s4Image will not be shown correctly with this backend.(t get_visibleRt get_xscalet get_yscaletwarningstwarnRRtnew_gctset_clip_rectangletfrozent set_clip_patht get_clip_pathR=t get_alphaRRR/R'RBtget_image_magnificationRRRRRtrestore( R RtargsR8tlRt widthDisplayt heightDisplayRRt((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pytdrawWs*   c C st|jr|j||S|j|j}}|j\}}}}||krf||}}n||kr||}}n|dk r|dk r||ko||ko||ko||k}nt}|ifS(sH Test whether the mouse event occured within the image. N(tcallablet _containstxdatatydataRR'RW( R t mouseeventRutyRbRcRdRetinside((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pytcontainsts  c C s|j}|dkrdS|r^|j\}}|j|jd|j||n|j|j\}}}tj ||||dS(s&Write the image to png file with fnameNi( RBR'R<RR,Rt flipud_outt as_rgba_strt_pngt write_png( R tfnametnoscaleRtRjRktrowstcolstbuffer((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRs     cC st|dr!t||_ntj||_|jjtjkrstj|jjtj  rst dn|jj d ks|jj dkr|jj dd krt dnd|_d|_d|_d|_dS( sI Set the image array ACCEPTS: numpy/PIL Image A tgetpixels#Image data can not convert to floatiiiis!Invalid dimensions for image dataN(ii(ii(thasattrt pil_to_arrayR9tcbooktsafe_masked_invalidRQRRRStcan_casttfloatt TypeErrorRTR;R'R.R?RORP(R R_((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pytset_datas(   cC s|j|dS(sq Retained for backwards compatibility - use set_data instead ACCEPTS: numpy array A or PIL ImageN(R(R R_((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyt set_arrays cC s|jS(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', or 'none'. (t_interpolation(R ((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pytget_interpolations cC sP|dkrtd}n|j}||jkrCtdn||_dS(s7 Set the interpolation method the image uses when resizing. if None, use a value from rc setting. If 'none', the image is shown as is without interpolating. 'none' is only supported in agg, ps and pdf backends and will fall back to 'nearest' mode for other backends. ACCEPTS: ['nearest' | 'bilinear' | 'bicubic' | 'spline16' | 'spline36' | 'hanning' | 'hamming' | 'hermite' | 'kaiser' | 'quadric' | 'catrom' | 'gaussian' | 'bessel' | 'mitchell' | 'sinc' | 'lanczos' | 'none' |] simage.interpolationsIllegal interpolation stringN(R'Rtlowert_interpdt ValueErrorR(R ts((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR,s    cC s&|dkrtd}n||_dS(sZ Set whether or not image resampling is used ACCEPTS: True|False simage.resampleN(R'Rt _resample(R tv((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR-s  cC s|jS(s!Return the image resample boolean(R(R ((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyt get_resamplescC s|rd|_n d|_dS(sy Set whether the resize filter norms the weights -- see help for imshow ACCEPTS: 0 or 1 iiN(t _filternorm(R R5((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR)s cC s|jS(sReturn the filternorm setting(R(R ((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pytget_filternormscC s+t|}|dkst||_dS(s Set the resize filter radius only applicable to some interpolation schemes -- see help for imshow ACCEPTS: positive float iN(RtAssertionErrorR+(R R6tr((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR*s cC s|jS(sreturn the filterrad setting(R+(R ((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyt get_filterrad sN(8t__name__t __module__tzorderRUtNEARESTtBILINEARtBICUBICtSPLINE16tSPLINE36tHANNINGtHAMMINGtHERMITEtKAISERtQUADRICtCATROMtGAUSSIANtBESSELtMITCHELLtSINCtLANCZOStBLACKMANRtdictt iteritemstkRt _interpdrtkeyst interpnamesR!R'RWR$R<R=R@RBRvt staticmethodRRRRRRRRRRR,R-RR)RR*R(((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR !sf                  1   (   X M        t AxesImagec B sYeZdZd d d d d ddedZddZdZdZdZ RS( cC sdt|jjjS(NsAxesImage(%g,%g;%gx%g)(RRRR(R ((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR!sig@c K sJ||_tj||d|d|d|d|d|d|d| | dS( 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 R2R3R4R(R5R6R7N(t_extentR R$( R R1R2R3R4R(textentR5R6R7R8((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR$s g?c"C s|jdkrtdn|j\}}}}|j}|jtj||f||fg}|d\}} |d\} } tj |j j |} |j |j|| | | g| \} }}}}}}|j j j}tjj|d}| j|| j| j\}}|dksE|dkrIdS| j|j|j| j|j|dkrd}n|| j||}|dkrd}n|| j||}| j|||j jj\}}}}t||dt||d}t||dt||d}||} ||}!| j | ||!|| j!t"|dt"|dd|j#d|j$| S(Ns9You must first set the image array or the image attributeiigg?R3tradius(%R9R'R:RRRRRRRwtTransformedBboxRtviewLimRvRRRRRYRRR<R,RRR-RRGRMtapply_translationRRtroundt apply_scalingRRIRR+("R RARJRRNRRRt_x1t_y1t_x2t_y2ttransformed_viewLimRtRbRdRfRgRhRiRRRjRkttxttyRRRttRRtrxtry((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRB9sN          #cC s=|jdkr9|jr"tStjd|jntS(sK return True if the image is better to be drawn unsampled. R skThe backend (%s) does not support interpolation='none'. The image will be interpolated with 'nearest` mode.(Rtoption_scale_imagetTrueRRt __class__RW(R R((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRus   cC s||_|\}}}}||f||ff}|jj||jjrn|jj||fddn|jjr|jj||fddndS(sc extent is data axes (left, right, bottom, top) for making image plots This updates ax.dataLim, and, if autoscaling, sets viewLim to tightly fit the image, regardless of dataLim. Autoscaling state is not changed, so following this with ax.autoscale_view will redo the autoscaling in accord with dataLim. tautoN(RRtupdate_datalimt _autoscaleXontset_xlimR't _autoscaleYontset_ylim(R RRbRcRdRetcorners((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyt set_extents   cC sq|jdk r|jS|j}|\}}|jdkrUd|d|ddfSd|dd|dfSdS(s.Get the image extent: left, right, bottom, topRCgg?N(RR'R<R((R tszRjRk((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRs  N( RRR!R'RWR$RBRR6R(((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRs   <  tNonUniformImagecB sneZdZdZddZdZdZdZdZdZ d Z d Z d Z RS( cK s6|jdd}tj||||j|dS(s kwargs are identical to those for AxesImage, except that 'interpolation' defaults to 'nearest', and 'bilinear' is the only alternative. R4R N(tpopRR$R,(R R1R8tinterp((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR$s cC stS(s; return False. Do not use unsampled image. (RW(R R((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRsg?c C s|jdkrtdn|j}t|jdkr|jtjkrx|j|dt }|j j |_ qtj |ddddtjfdd}d|dddddf((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR=sN( RRt__doc__R'R$RBR@RRRRR=(((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRK#s    ! t FigureImagecB sweZdZd d ddd dZdZdZdZdZdZ ddZ e d Z d Z RS( icK s}tjj|tjj||||dkr?td}n||_||_||_ ||_ |j |d|_ dS(s 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 s image.origing?N( R"R#R$R%R&R'RR(tfiguretoxtoyR0RA(R tfigR2R3toffsetxtoffsetyR(R8((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR$s       c C st|jr|j||S|j\}}}}|j|j}}|dk r|dk r||ko||ko||ko||k}nt}|ifS(s6Test whether the mouse event occured within the image.N(RRRRuRR'RW( R RRbRcRdReRRR((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRscC s,|jdkrtdn|jjd S(s+Get the numrows, numcols of the input images"You must first set the image arrayiN(R9R'R:R;(R ((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR<scC sF|j\}}d|j|d|jd|j|d|jfS(s.Get the image extent: left, right, bottom, topgg?(R<RXRY(R RjRk((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRscC s tjj|tj|dS(sSet the image array.N(R%R&RRR(R R_((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRscC s|j|dS(s@Deprecated; use set_data for consistency with other image types.N(R(R R_((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRsg?c C s9|jdkrtdn|j|jdt}||_|dk}|rZd}nd}tj||}|jj }|j t j j|d|j jdkot|jjdk|_|r|j\}}||9}||9}|jtj|j||n|jdkr5|jn|S(Ns"You must first set the image arrayRDiitgrayiRC(R9R'R:RYR-RARURVRWRRRRR2tnameR;R;RXR<R,RRR(R( R RARutismagtisoutputRtRRjRk((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRBs,      cO s|jsdS|j|j}|j}|j|jj|j|j|j |j |j |t |j t |j||jdS(N(RRBRRRRWRRRR=RRR RXRYR(R RRR8RtR((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRs  (cC s;|j}|j\}}}tj||||dS(s&Write the image to png file with fnameN(RBRRR(R RRtRRR((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRs N(RRRR'R$RR<RRRRBRRR(((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRVs        t BboxImagec B sheZdZd d d d ddeedZd dZdZdZ ddZ e d Z RS( s;The Image class whose size is determined by the given bbox.ig@c K sVtj|dd d|d|d|d|d|d|d|| ||_| |_d S( sG cmap is a colors.Colormap instance norm is a colors.Normalize instance to map luminance to 0-1 interp_at_native is a flag that determines whether or not interpolation should still be applied when the image is displayed at its native resolution. A common use case for this is when displaying an image for annotational purposes; it is treated similarly to Photoshop (interpolation is only used when displaying the image at non-native resolutions). kwargs are an optional list of Artist keyword args R1R2R3R4R(R5R6R7N(R R$R'Rtinterp_at_native( R RR2R3R4R(R5R6R7RbR8((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR$s cC sc|dkr|jj}nt|jtr7|jSt|jrS|j|StddS(Nsunknown type of bbox(R't get_figuret_cachedRenderert isinstanceRRRR(R R((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pytget_window_extent@s  cC sjt|jr|j||S|js5tifS|j|j}}|jj||}|ifS(s6Test whether the mouse event occured within the image.(RRRRWRuRRfR(R RRuRR((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRKs  cC s,|jdkrtdn|jjd S(s+Get the numrows, numcols of the input images"You must first set the image arrayiN(R9R'R:R;(R ((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyR<Xsg?cC s]|jdkrtdn|jdkr'|jjtjkr{t|jjdkr{t j |jd}t |_ n|j dkr|j|jdt}||_ n |j }t j |d}t|jjdkr|jj|_ n t |_ ||_|jdkr0|jq0n |j}|j|j|j|j|j|j|j|j\}}}}t|t|} t|t|} | |9} | |9} |jjd \} } |j r| | kr| | kr|jdn| | } | | }|j| ||jt | t | d|j!d|j"|S( Ns9You must first set the image array or the image attributeiiRDiRCR3R(#R9R'R:R.RQRRRSR;R;RURVRWRXR?RYR-R2R]R(R^RR,RRR-RRfRR RbR!RRIRR+(R RRARtRuRRRR)RRRjRkR*R+((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRB_sH-            c O s|jsdS|j}|j||}|j|j\}}}} |j} |j| | j|j|j | t |t ||| j dS(N( RRRBRfRRt _set_gc_clipR=RRR R( R RRR8t image_magRtRRRR)R((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRs    "N( RRRUR'RWR-R$RfRR<RBRR(((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyRas !  9c C s>d}itjd6}|dkrtj|r_tjj|\}}|jd}qt |drtjj|j \}}|jd}qd}n|}||j kr||}|dkrt d|j n|S||}tj|r0t|d}||SWdQXn ||SdS(s Read an image from a file into an array. *fname* may be a string path or a Python file-like object. If using a file object, it must be opened in binary mode. If *format* is provided, will try to read file of that type, otherwise the format is deduced from the filename. If nothing can be deduced, PNG is tried. Return value is a :class:`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 :func:`~matplotlib.pyplot.imshow`. cS syddlm}Wntk r(dSXtj|rlt|d }|j|}t|SWdQXn|j|}t|SdS(s-try to load the image with PIL or return Nonei(tImagetrbN(tPILRit ImportErrorR'Rtis_string_liketopenR(RRitfhtimage((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pytpilreads tpngiR^s\Only know how to handle extensions: %s; with PIL installed matplotlib can handle more imagesRjN(Rtread_pngR'RRmtostpathtsplitextRRR^titerkeysRRRn( RtformatRqthandlerstbasenametextRtthandlertfd((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pytimreads,      idc C sddlm}ddlm} g|jd|jdfD]} | t|^q;} | d| d|dt} || } | j|d |d |d |d |}| j|d|d |dt dS(s' Save an array as in image file. 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*: An MxN (luminance), MxNx3 (RGB) or MxNx4 (RGBA) 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. *dpi* The DPI to store in the metadata of the file. This does not affect the resolution of the output image. i(tFigureCanvasAgg(tFigureiitfigsizetdpitframeonR2tvmintvmaxR(Rxt transparentN( tmatplotlib.backends.backend_aggRtmatplotlib.figureRR;RRWtfigimagetsavefigR-(RtarrRRR2RxR(Rt FigureCanvasRRuRRZtcanvasRt((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pytimsaves"7 'cC stjd}|jdkr'|}n/|jdkri|}||}|jd|jdf|_|S|jdkr|}||}|jd|jddf|_|S|jjd r#|}|jjd r||d }n||d }|jd|jdf|_|jd Sy|jd}Wnt k rUt dnX||}|jd|jddf|_|S(s Load a PIL image and return it as 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 cS s+|jd|j}tj||}|S(sTeturn a 1D array of dtype.traw(ttostringtmodeRRt fromstring(RtRQtx_strRu((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyttoarraystRGBAtRGBXtLiitRGBisI;16RCs>u2s`_ 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 idiNRRs.png(Rs.pdf(tFigureCanvasPdfs.svg(tFigureCanvasSVGs0Can only handle extensions 'png', 'svg' or 'pdf'(RiitaspectR/RtxtickstyticksR7R4R (RtRutsplitRvR~R;RRtmatplotlib.pyplottpyplotRWRRtmatplotlib.backends.backend_pdfRtmatplotlib.backends.backend_svgRRRRtadd_axesRWtimshowR-R(tinfilet thumbfiletscaleR4tpreviewtbasedirRztbaseouttextoutRtRRtdepthRRFREt extensiontpltRZRRRR1R{((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyt thumbnailHs6%  !     (/RUt __future__RRRtRtmathtnumpyRRRt matplotlibRtmatplotlib.artisttartistR"Rtmatplotlib.colorstcolorsRt matplotlib.cmR%tmatplotlib.cbookRtmatplotlib._imageRUtmatplotlib._pngRtmatplotlib.transformsRRRt transformsRwR#R&R RR8RKRVRaR'R~RRRWR(((sJ/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/image.pyts<     }s E + /