m[c@`sdZddlmZmZmZmZddlZddlmZddl m Z ddl m Z ddl mZddlZddlZddlZddlmZddljZdd lmZddljZddljZddljZddl j!Z!ddl"j#Z#dd l Tdd l$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*ej+e,Z-ie!j.d 6e!j.d 6e!j/d6e!j0d6e!j1d6e!j2d6e!j3d6e!j4d6e!j5d6e!j6d6e!j7d6e!j8d6e!j9d6e!j:d6e!j;d6e!j<d6e!j=d6e!j>d6Z?e@e?ZAddZBeCd ZDd!ZEd"ejFejGfd#YZHd$eHfd%YZId&eIfd'YZJd(eIfd)YZKd*eHfd+YZLd,eHfd-YZMeCd.ZNeCeCeCeCeCd/d0ZOd1ZPd2deQd3ZRdS(4uS The image module supports basic image loading, rescaling and display operations. i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(turlparse(turlopen(tBytesIO(tceil(trcParams(tallow_rasterization(t*(tAffine2DtBboxBasetBboxt BboxTransformtIdentityTransformtTransformedBboxunoneunearestubilinearubicubicuspline16uspline36uhanninguhamminguhermiteukaiseruquadricucatromugaussianubesselumitchellusinculanczosublackmang?c C`st|dkr1tjddtjddfSg}g}x|D]}|j||\}}}} |d k rD||9}||9}|j||||jpdf|jt||g||j d||j dggqDqDWt|dkr tjd dtjddfStj |} tj t | j t | jdfdtj} xb|D]Z\}}}} tj|| j|| j} tj|| | tjdtd| qiW| | j|| j|fS( uD Composite a number of RGBA images into one. The images are composited in the order in which they appear in the `images` list. Parameters ---------- images : list of Images Each must have a `make_image` method. For each image, `can_composite` should return `True`, though this is not enforced by this function. Each image must have a purely affine transformation with no shear. renderer : RendererBase instance magnification : float The additional magnification to apply for the renderer in use. Returns ------- tuple : image, offset_x, offset_y Returns the tuple: - image: A numpy array of the same type as the input images. - offset_x, offset_y: The offset of the image (left, bottom) in the output figure. iitdtypeg?itresampletalpha(iiiN(iii(tlentnptemptytuint8t make_imagetNonetappendt get_alphaR tshapetuniontzerostinttheighttwidthR t translatetx0ty0t_imageRtNEARESTtFalse( timagestrenderert magnificationtpartstbboxestimagetdatatxtyttranstbboxtoutputR((s/lib/python2.7/site-packages/matplotlib/image.pytcomposite_imagesAs,    %<-#c`std|D}|dk r(|n j}|sA| rbx|D]}|jqHWngjfd}xM|D]E}t|tr|jrj|q||jqW|dS(u Draw a sorted list of artists, compositing images into a single image where possible. For internal matplotlib use only: It is here to reduce duplication between `Figure.draw` and `Axes.draw`, but otherwise should not be generally useful. cs`s|]}t|tVqdS(N(t isinstancet _ImageBase(t.0R/((s/lib/python2.7/site-packages/matplotlib/image.pys sc`stdkr&djntdkrt\}}}|jdkrj}|jj|jjj |t j |t j |||j qn2dS(Nii( RtdrawR4tsizetnew_gctset_clip_rectangleR2t set_clip_patht get_clip_patht draw_imageRtroundtrestore(R.tltbtgc(t image_grouptmagtparentR)(s/lib/python2.7/site-packages/matplotlib/image.pyt flush_imagess (N( tanyRtoption_image_nocompositeR8tget_image_magnificationR5R6t can_compositeR(R)RFtartiststsuppress_compositet has_imagest not_compositetaRG((RDRERFR)s/lib/python2.7/site-packages/matplotlib/image.pyt_draw_list_compositing_images{s      cC`stj|jd|jddfd|j}||ddddddf<|jtjkrd|dddddfs (tsixt iteritemsRU(RV((s/lib/python2.7/site-packages/matplotlib/image.pyt _interpdrst alternativeumpl.image.interpolation_namescC`stS(N(tinterpolations_names(RV((s/lib/python2.7/site-packages/matplotlib/image.pyt iterpnamesscC`sdt|jjjS(NuAxesImage(%g,%g;%gx%g)(ttupletaxesR2tbounds(RV((s/lib/python2.7/site-packages/matplotlib/image.pyt__str__sig@c K`stjj|tjj|||t|_|dkrHtd}n||_ |j ||j ||j ||j |||_d|_|j| dS(u 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 u image.originN(tmartisttArtistt__init__tcmtScalarMappabletTruet _mouseoverRRtorigintset_filternormt set_filterradtset_interpolationt set_resampleRat_imcachetupdate( RVtaxtcmaptnormt interpolationRkt filternormt filterradRtkwargs((s/lib/python2.7/site-packages/matplotlib/image.pyRfs          cC`s#tt|j}d|d<|S(Nu_imcache(tsuperR6t __getstate__R(RVtstate((s/lib/python2.7/site-packages/matplotlib/image.pyRzs cC`s,|jdkrtdn|jjd S(u+Get the numrows, numcols of the input imageu"You must first set the image arrayiN(t_ARt RuntimeErrorR(RV((s/lib/python2.7/site-packages/matplotlib/image.pytget_sizescC`s tjj||d|_dS(uw Set the alpha value used for blending - not supported on all backends ACCEPTS: float N(RdRet set_alphaRRp(RVR((s/lib/python2.7/site-packages/matplotlib/image.pyRscC`s&d|_d|_tjj|dS(ub Call this whenever the mappable is changed so observers can update state N(RRpt _rgbacacheRgRhtchanged(RV((s/lib/python2.7/site-packages/matplotlib/image.pyR s  g?c$ C`s|dkrtdn|jdkr9tdntj||}|dkr[dS|j|} |j|} | dks| dkrdS|jdkrtj d|j d j dd} n t } | tj |j|j d|j|j dj |j |j|j7} | tj |j |j j ||} | jr|r| ddks| ddkrtt| } tt| }| | | }|| | }| tj d|d|7} nt| } t| }|s|jdkr.td j|j n|jd krO|j}|j}|j}|tjjkrtjdtjd}}n|jd kr|j}nC|jtj|jtj}|d krtj}n tj }tj!|j d|}||(|j"j#|tj|j"j$tj|j"j%}|j"j%|d }|tjkrpdnd}|||}||krd}ntj|}|||}||krd}ntj|}|dk s|dk r tj&|||}n||8}tj'|j|}tj'|j|}||kre|||d}n|d7}tj(|| fd|j}t)j*||| t+|j,|j-d|j.pd|j/pd~|d8}||kr|||d9}n||7}t0|j"t1j2r9|j|j}ntj!|j dtj }|j3j |j krtj4|j3tj tj5tj d|(nd|(tj(|| fd|j}t)j*||| t+|j,t6d|j.pd|j/pd~tj7|}tj8|}d||<|j"tjj9||} n|j d d krqt:|}n,|j d dkrtd|j fntj(|| dfd|j} |j;}!|!dkrd}!nt)j*|| | t+|j,|j-|!|j.pd|j/p%d|j<| dt6dt=} |jd kr|j;}!|!dkrtd}!n| ddddd f}"tj>tj>|"tj ||!tj?|"(qn|j@dkr|j<|dt6d|jd k|_@n|j@} tA|| jBjCjB}#| tt|#jDdtt|#jEd| j dtt|#jFdtt|#jGd| j df} tj tt|#jFdtt|#jDd| } | |j |j| fS(uM Normalize, rescale and color the image `A` from the given in_bbox (in data space), to the given out_bbox (in pixel space) clipped to the given clip_bbox (also in pixel space), and magnified by the magnification factor. `A` may be a greyscale image (MxN) with a dtype of `float32`, `float64`, `uint16` or `uint8`, or an RGBA image (MxNx4) with a dtype of `float32`, `float64`, or `uint8`. If `unsampled` is True, the image will not be scaled, but an appropriate affine transformation will be returned instead. If `round_to_pixel_border` is True, the output image size will be rounded to the nearest pixel boundary. This makes the images align correctly with the axes. It should not be used in cases where you want exact scaling, however, such as FigureImage. Returns the resulting (image, x, y, trans), where (x, y) is the upper left corner of the result in pixel space, and `trans` is the affine transformation from the image to pixel space. u9You must first set the image array or the image attributeiuk_make_image must get a non-empty image. Your Artist's draw method must filter before this method is called.uupperiig?giiuInvalid dimensions, got {}ufgחARgcAg@g?g?iuInvalid dimensions, got %stbytesRtN(NiiN(NiiN(ii(HRR}R9R t intersectionR!R RkR R"RtscaleRR#R$t get_transformt is_affineRRtndimt ValueErrortformatRtmintmaxRtmatmaskedtint32tkindtastypetfloat64tfloat32RRttautoscale_NonetvmaxtvmintcliptasscalarRR%RRUtget_interpolationt get_resampletget_filternormt get_filterradR5tmcolorstNoNormtmasktwheretnanRitarraytisnant masked_arrayRTRtto_rgbaR'tasarrayRRpRtfrozentinvertedtymintymaxtxmintxmax($RVRRtin_bboxtout_bboxt clip_bboxR*t unsampledtround_to_pixel_bordert clipped_bboxtout_width_basetout_height_basett0ttt out_widtht out_heightt extra_widtht extra_heightt inp_dtypeta_minta_maxt scaled_dtypetdatA_scaledtdvtvmidtfacttnewmintnewmaxt A_resampledRtout_maskt out_alphaR3Rt alpha_channeltsubset((s/lib/python2.7/site-packages/matplotlib/image.pyt _make_images    ,      $     " "                      !!    "   * #* 4cC`stddS(Nu)The make_image method must be overridden.(R}(RVR)R*R((s/lib/python2.7/site-packages/matplotlib/image.pyR!scC`su|j|dt\}}}}|dkr1dStj|jd|jd|}|j|||||dS(uu draw unsampled image. The renderer should support a draw_image method with scale parameter. RNii(RRiRR RRR>(RVR)RCtimRARBR1((s/lib/python2.7/site-packages/matplotlib/image.pyt_draw_unsampled_image$s ! 'cC`stS(u{ return True if the image is better to be drawn unsampled. The derived class needs to override it. (R'(RVR)((s/lib/python2.7/site-packages/matplotlib/image.pyt_check_unsampled_image3sc O`s|jst|_dS|jjdkr;t|_dS|j}|j||j|j|j |j |j |j |j |r|jjr|j||nI|j||j\}}}}|dk r|j||||n|jt|_dS(Ni(t get_visibleR'tstalet get_arrayR9R:t _set_gc_clipRRtset_urltget_urltset_gidtget_gidRRRRRRJRR>R@( RVR)targsRxRCRRARBR1((s/lib/python2.7/site-packages/matplotlib/image.pyR8:s(       c C`st|jr|j||S|j|j}}|j\}}}}||krf||}}n||kr||}}n|dk r|dk r||ko|kno||ko|kn}nt}|ifS(uI Test whether the mouse event occurred within the image. N(tcallablet _containstxdatatydatat get_extentRR'( RVt mouseeventR/R0RRRRtinside((s/lib/python2.7/site-packages/matplotlib/image.pytcontainsXs  ;cC`sW|j|jdkr+|jdddn|jdtdt}tj||dS(u&Write the image to png file with fnameulowerNiRRt(RRkR|Rit_pngt write_png(RVtfnameR((s/lib/python2.7/site-packages/matplotlib/image.pyRps4cC`st|drK|jdkr9t|jd|_qct||_ntj|dt|_|jjt j krt j |jjt d rt dn|jjdkp|jjdko|jjd dkst d n|jjdkrt j|jjt jrd nd }|jjdksO||jjkrztjdt j|jd||_n|jjt j krt j|jjt jr|jjt j |_qnd|_d|_t|_dS(u Set the image array. ACCEPTS: numpy/PIL Image A Note that this function does *not* update the normalization used. ugetpixeluLuRGBAtcopyu same_kindu'Image data cannot be converted to floatiiiiu!Invalid dimensions for image dataiiiumClipping input data to the valid range for imshow with RGB data ([0..1] for floats or [0..255] for integers).N(ii(thasattrtmodet pil_to_arraytconvertR|tcbooktsafe_masked_invalidRiRRRtcan_casttfloatt TypeErrorRRt issubdtypetintegerRRt_logtwarningRRRRpRR(RVRRthigh((s/lib/python2.7/site-packages/matplotlib/image.pytset_datavs. ('*$   cC`s|j|dS(uz Retained for backwards compatibility - use set_data instead ACCEPTS: numpy array A or PIL Image N(R(RVRR((s/lib/python2.7/site-packages/matplotlib/image.pyt set_arrays cC`s|jS(u* 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(RV((s/lib/python2.7/site-packages/matplotlib/image.pyRs cC`sV|dkrtd}n|j}|tkr@tdn||_t|_dS(u< 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' ] uimage.interpolationuIllegal interpolation stringN(RRtlowerRURRRiR(RVts((s/lib/python2.7/site-packages/matplotlib/image.pyRns     cC`s+|j}|jdko*|jo*|jS(uS Returns `True` if the image can be composited with its neighbors. unone(RRRt is_separable(RVR1((s/lib/python2.7/site-packages/matplotlib/image.pyRKs  cC`s/|dkrtd}n||_t|_dS(u[ Set whether or not image resampling is used. ACCEPTS: True|False uimage.resampleN(RRt _resampleRiR(RVRY((s/lib/python2.7/site-packages/matplotlib/image.pyRos   cC`s|jS(u"Return the image resample boolean.(R(RV((s/lib/python2.7/site-packages/matplotlib/image.pyRscC`s(|rd|_n d|_t|_dS(uy Set whether the resize filter norms the weights -- see help for imshow ACCEPTS: 0 or 1 iiN(t _filternormRiR(RVRv((s/lib/python2.7/site-packages/matplotlib/image.pyRls  cC`s|jS(uReturn the filternorm setting.(R(RV((s/lib/python2.7/site-packages/matplotlib/image.pyRscC`s=t|}|dkr'tdn||_t|_dS(u Set the resize filter radius only applicable to some interpolation schemes -- see help for imshow ACCEPTS: positive float iu+The filter radius must be a positive numberN(RRt _filterradRiR(RVRwtr((s/lib/python2.7/site-packages/matplotlib/image.pyRms    cC`s|jS(uReturn the filterrad setting.(R(RV((s/lib/python2.7/site-packages/matplotlib/image.pyR s(%t__name__t __module__tzordertpropertyRt deprecatedRWR\R_RcRR'RfRzR~RRRiRRRRR R8RRRRRRnRKRoRRlRRmR(((s/lib/python2.7/site-packages/matplotlib/image.pyR6sN!         /     t AxesImagec B`sqeZdZd d d d d ddedZd dZdedZdZdZ d Z d Z RS( cC`sdt|jjjS(NuAxesImage(%g,%g;%gx%g)(R`RaR2Rb(RV((s/lib/python2.7/site-packages/matplotlib/image.pyRcsig@c K`sP||_tt|j|d|d|d|d|d|d|d| | dS( u 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 RsRtRuRkRvRwRN(t_extentRyRRf( RVRrRsRtRuRktextentRvRwRRx((s/lib/python2.7/site-packages/matplotlib/image.pyRfs cC`sC|j\}}}}tj||||g}|j|jjS(N(RR t from_extentst transformedRat transData(RVR)R#tx1R$ty1R2((s/lib/python2.7/site-packages/matplotlib/image.pytget_window_extent<sg?c C`s|j}|j\}}}}ttj||g||gg} t| |} |j|j| | |jj |d|S(NR( RRR RRRRR|RaR2( RVR)R*RR1Rtx2Rty2R2ttransformed_bbox((s/lib/python2.7/site-packages/matplotlib/image.pyRAs 'cC`s|jdko|jS(uK Return whether the image would be better drawn unsampled. unone(Rtoption_scale_image(RVR)((s/lib/python2.7/site-packages/matplotlib/image.pyRLscC`s||_\}}}}||f||ff}|jj|||g|jj(||g|jj(|jjr|jj||fddn|jj r|jj ||fddnt |_ dS(ub 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( RRatupdate_datalimt sticky_edgesR/R0t _autoscaleXontset_xlimRt _autoscaleYontset_ylimRiR(RVRRRRRtcorners((s/lib/python2.7/site-packages/matplotlib/image.pyt set_extentSs   cC`sq|jdk r|jS|j}|\}}|jdkrUd|d|ddfSd|dd|dfSdS(u.Get the image extent: left, right, bottom, topuuppergg?N(RRR~Rk(RVtsztnumrowstnumcols((s/lib/python2.7/site-packages/matplotlib/image.pyRgs  cC`sI|j\}}}}|jdkr7||}}n|j}t||g||gg}tddg|jd g}td|d|} |j|j} } | j| | g} t t j | rdS| j t\} }d| ko |jdkn s3d|ko-|jdkn r7dS|| |fSdS(u%Get the cursor data for a given eventuupperiitboxintboxoutiN(RRkRR RRRRttransform_pointRHRRRRR(RVteventRRRRtarrt data_extentt array_extentR1R0R/tpointtitj((s/lib/python2.7/site-packages/matplotlib/image.pytget_cursor_datass HN( RRRcRR'RfRRRRRR#(((s/lib/python2.7/site-packages/matplotlib/image.pyRs     tNonUniformImagecB`sqeZdZdZdedZdZdZdZdZ dZ d Z d Z d Z RS( cK`s<|jdd}tt|j|||j|dS(u kwargs are identical to those for AxesImage, except that 'nearest' and 'bilinear' are the only supported 'interpolation' options. u interpolationunearestN(tpopRyR$RfRn(RVRrRxtinterp((s/lib/python2.7/site-packages/matplotlib/image.pyRfscC`stS(u; return False. Do not use unsampled image. (R'(RVR)((s/lib/python2.7/site-packages/matplotlib/image.pyRsg?c C`s|jdkrtdn|r3tdn|j}|jdkr|jtjkr|j|dt }|j j |_ qtj |ddddtjfdd}d|dddddf 1 2%  $$  cC`sHtj|tj}tj|tj}tj|dt}|j|jko\dkno~|jdd!|j|jkstdn|jd krtdn|jdkr|jdd krtd n|jdkr|jddkr|jdd!|_n||_ ||_ ||_ d |_ t|_d S( u^ Set the grid for the pixel centers, and the pixel values. *x* and *y* are monotonic 1-D ndarrays of lengths N and M, respectively, specifying pixel centers *A* is an (M,N) ndarray or masked array of values to be colormapped, or a (M,N,3) RGB array, or a (M,N,4) RGBA array. RiiiuAxes don't match array shapeiuCan only plot 2D or 3D dataiu?3D arrays must have three (RGB) or four (RGBA) color componentsN(ii(iii(RRRRRRiRRRR|R/R0RRpR(RVR/R0RR((s/lib/python2.7/site-packages/matplotlib/image.pyRs B""    cG`stddS(NuMethod not supported(tNotImplementedError(RVR((s/lib/python2.7/site-packages/matplotlib/image.pyRscC`s;|dk r'|dkr'tdntj||dS(u| Parameters ---------- s : str, None Either 'nearest', 'bilinear', or ``None``. unearestubilinearu?Only nearest neighbor and bilinear interpolations are supportedN(unearestubilinear(RR4RRn(RVR((s/lib/python2.7/site-packages/matplotlib/image.pyRnscC`sJ|jdkrtdn|jd|jd|jd|jdfS(NuMust set data firstii(R|RR}R/R0(RV((s/lib/python2.7/site-packages/matplotlib/image.pyRscC`sdS(N((RVR((s/lib/python2.7/site-packages/matplotlib/image.pyRlscC`sdS(N((RVR((s/lib/python2.7/site-packages/matplotlib/image.pyRmscC`s8|jdk rtdntt|j|dS(Nu'Cannot change colors after loading data(R|RR}RyR$tset_norm(RVRt((s/lib/python2.7/site-packages/matplotlib/image.pyR5scC`s8|jdk rtdntt|j|dS(Nu'Cannot change colors after loading data(R|RR}RyR$tset_cmap(RVRs((s/lib/python2.7/site-packages/matplotlib/image.pyR6s(RRRfRR'RRRRnRRlRmR5R6(((s/lib/python2.7/site-packages/matplotlib/image.pyR$s '      t PcolorImagecB`sYeZdZddddddZdedZdZdZdZ dZ RS( u 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. cK`sUtt|j|d|d||j||dk rQ|j|||ndS(u 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 RtRsN(RyR7RfRqRR(RVRrR/R0RRRsRtRx((s/lib/python2.7/site-packages/matplotlib/image.pyRf s"  g?c C`s|jdkrtdn|r3tdn|jjj}tj|d}t j |dj t j }|jj j\}}}} t j|dt j|d} t j| dt j|d} tt j| |} tt j| |} |jdkre|j|jdt} | |_|jjdkrn|jj|_qnn |j} |jj} tj|j|j| | | | j| j| j| jf|}|||t fS(Nu"You must first set the image arrayu&unsampled not supported on PColorImageiig?Ri(!R|RR}RRatpatcht get_facecolorRRRRRRR2R-R?RRRiRRsR'R(R,R%tpcolor2R/R0R#RR$RR(RVR)R*RtfctbgRARBRRR!R RRtvlR((s/lib/python2.7/site-packages/matplotlib/image.pyRs2$$    cC`stS(N(R'(RVR)((s/lib/python2.7/site-packages/matplotlib/image.pyR<scC`stj|dt}|d krJtjd|jdddtj}ntj|tjj }|d krtjd|jdddtj}ntj|tjj }|jd |j d|j dfkrt d|jd |j d|j dffn|j d kr.t dn|j dkrc|jddkrc|jd |_nt |_|j dkr4|jddkr%|d d d d df|d d d d dfkjr1|d d d d df|d d d d dfkjr1t|_q1q4t d n|d |dkr}|d d d }|d d d d d f}n|d |dkr|d d d }|d d d }n||_||_||_d |_t|_d S(u Set the grid for the rectangle boundaries, and the data values. *x* and *y* are monotonic 1-D ndarrays of lengths N+1 and M+1, respectively, specifying rectangle boundaries. If None, they will be created as uniform arrays from 0 through N and 0 through M, respectively. *A* is an (M,N) ndarray or masked array of values to be colormapped, or a (M,N,3) RGB array, or a (M,N,4) RGBA array. RiiRiu2Axes don't match array shape. Got %s, expected %s.iuA must be 2D or 3DiNu+3D arrays must have RGB or RGBA as last dimi(ii(ii(RRRiRRtarangeRRRtravelR9RRR'R(tallR|R/R0RR(RVR/R0RR((s/lib/python2.7/site-packages/matplotlib/image.pyR?sB ) )'." DD"    cG`stddS(NuMethod not supported(R4(RVR((s/lib/python2.7/site-packages/matplotlib/image.pyRvscC`s|j|j}}||jdks_||jdks_||jdks_||jdkrcdStj|j|d}tj|j|d}y|j||fSWntk rdSXdS(u%Get the cursor data for a given eventiiiN( RRR/R0RRt searchsortedR|t IndexError(RVRR/R0R"R!((s/lib/python2.7/site-packages/matplotlib/image.pyR#ys&& N( RRt__doc__RRfR'RRRRR#(((s/lib/python2.7/site-packages/matplotlib/image.pyR7s   7 t FigureImagecB`sMeZdZdZddddddZdZdedZdZ RS(iunearestcK`s]tt|jdd|d|d|||_||_||_|j|d|_dS(u 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 RtRsRkg?N( RyRDRfRtfiguretoxtoyRqR*(RVtfigRsRttoffsetxtoffsetyRkRx((s/lib/python2.7/site-packages/matplotlib/image.pyRfs    cC`sF|j\}}d|j|d|jd|j|d|jfS(u.Get the image extent: left, right, bottom, topgg?(R~RFRG(RVRR((s/lib/python2.7/site-packages/matplotlib/image.pyRsg?c C`s|j|jj}t|j||j|g|j||jjd|j||jjdgg}|jj\}}||j9}||j9}tddg||gg}|j|j|||d||d|dt S(NiiR*RR( tdpiRER RFRGR|Rtget_size_inchesRR'( RVR)R*RtfacR2R!R R((s/lib/python2.7/site-packages/matplotlib/image.pyRs$  cC`s/tjj|tj|dtt|_dS(uSet the image array.RN(RgRhRRRRiR(RVRR((s/lib/python2.7/site-packages/matplotlib/image.pyRs N( RRRRRRfRR'RR(((s/lib/python2.7/site-packages/matplotlib/image.pyRDs  t BboxImagec B`s\eZdZd d d d ddeedZdZd dZdZ dedZ RS( u;The Image class whose size is determined by the given bbox.ig@c K`sett|jdd|d|d|d|d|d|d|| ||_| |_t|_dS( uG 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 RsRtRuRkRvRwRN(RyRNRfRR2tinterp_at_nativeRt _transform( RVR2RsRtRuRkRvRwRRORx((s/lib/python2.7/site-packages/matplotlib/image.pyRfs  cC`s|jS(N(RP(RV((s/lib/python2.7/site-packages/matplotlib/image.pyRscC`sc|dkr|jj}nt|jtr7|jSt|jrS|j|StddS(Nuunknown type of bbox(Rt get_figuret_cachedRendererR5R2R RR(RVR)((s/lib/python2.7/site-packages/matplotlib/image.pyRs  cC`sjt|jr|j||S|js5tifS|j|j}}|jj||}|ifS(u7Test whether the mouse event occurred within the image.(RRRR'R/R0RR(RVRR/R0R((s/lib/python2.7/site-packages/matplotlib/image.pyRs  g?c C`s|j\}}|j|j}|j||g_|j|}tddg||gg}ttddgddgg||_|j|j||||d|S(NiiR( tget_canvas_width_heightRRt_pointsR RRPRR|( RVR)R*RR!R tbbox_intbbox_outR((s/lib/python2.7/site-packages/matplotlib/image.pyR s*N( RRRCRR'RiRfRRRR(((s/lib/python2.7/site-packages/matplotlib/image.pyRNs "  c C`sd}itjd6}|dkrt|tjrt|}t|jdkrad}qt j j |\}}|j d}qt |drt j j |j\}}|j d}qd}n|}||kr||}|dkrtdt|n|S||}t|tjrt|}t|jdkrxtt|j} || St|d} || SWdQXn ||SdS(u Read an image from a file into an array. *fname* may be a string path, a valid URL, 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`. Note, URL strings may not be compatible with PIL. Check the PIL documentation for more information. cS`sOyddlm}Wntk r(dSX|j|}t|SWdQXdS(u-try to load the image with PIL or return Nonei(tImageN(tPILRWt ImportErrorRtopenR(RRWR-((s/lib/python2.7/site-packages/matplotlib/image.pytpilread1s  upngiunameu_Only know how to handle extensions: %s; with Pillow installed matplotlib can handle more imagesurbN(Rtread_pngRR5RZt string_typesRRtschemetostpathtsplitextRRtnameRR+RRtreadRZ( RRR[thandlerstparsedtexttbasenameRthandlertfd((s/lib/python2.7/site-packages/matplotlib/image.pytimreads:           idc C`s>ddlm}ddlm} t|ttddrMtj|}n|dks|dkrt|t j r|j j drt dd|d|} | j|| j||| j|ni| d |d t} || | j|d|d |d |d|d t| j|d |d|dtdS(uF Save an array as in image file. The output formats available depend on the backend being used. Parameters ---------- fname : str or file-like Path string 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 : array-like An MxN (luminance), MxNx3 (RGB) or MxNx4 (RGBA) array. 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 : matplotlib.colors.Colormap, optional For example, ``cm.viridis``. If ``None``, defaults to the ``image.cmap`` rcParam. format : str One of the file extensions supported by the active backend. Most backends support png, pdf, ps, eps and svg. origin : [ 'upper' | 'lower' ] Indicates whether the ``(0, 0)`` index of the array is in the upper left or lower left corner of the axes. Defaults to the ``image.origin`` rcParam. dpi : int The DPI to store in the metadata of the file. This does not affect the resolution of the output image. i(tFigureCanvasAgg(tFigureuPathLikeupngu.pngRsRkRKtframeonRRtresizeRt transparentN((tmatplotlib.backends.backend_aggRktmatplotlib.figureRlR5tgetattrR_tfspathRRZR]RtendswithRRtset_climRR'tfigimageRitsavefig( RRRRRsRRkRKt FigureCanvasRlR-RH((s/lib/python2.7/site-packages/matplotlib/image.pytimsavefs""    $cC`s|jdkrtj|S|jjdr|jd|j}|jjdrjtj|d}ntj|d }|j|jd d d j d Sy|j d}Wnt k rt d nXtj|Sd S(uLoad a PIL image and return it as a numpy array. Grayscale images are returned as ``(M, N)`` arrays. RGB images are returned as ``(M, N, 3)`` arrays. RGBA images are returned as ``(M, N, 4)`` arrays. uRGBAuRGBXuRGBuLuI;16urawuBu>u2u`_ 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:`sphx_glr_gallery_misc_image_thumbnail_sgskip.py` Return value is the figure instance containing the thumbnail idiNtfigsizeRKu.png(Rku.pdf(tFigureCanvasPdfu.svg(tFigureCanvasSVGu0Can only handle extensions 'png', 'svg' or 'pdf'(RlitaspectuautoRmtxtickstyticksRRu(R_R`tsplitRaRjRRtmatplotlib.pyplottpyplotRERpRktmatplotlib.backends.backend_pdfRtmatplotlib.backends.backend_svgRRRqRltadd_axesR'timshowRiRw(tinfilet thumbfileRRutpreviewtbasedirRgtbaseouttextoutRtrowstcolstdepthRKR R!t extensiontpltRHRxRlRrRf((s/lib/python2.7/site-packages/matplotlib/image.pyt thumbnails6%  !     (SRCt __future__RRRRRZtsix.moves.urllib.parseRtsix.moves.urllib.requestRtioRtmathRR_tloggingtnumpyRt matplotlibRtmatplotlib.artisttartistRdR tmatplotlib.colorstcolorsRt matplotlib.cmRgtmatplotlib.cbookRtmatplotlib._imageR%tmatplotlib._pngRtmatplotlib.transformsR R R RRRt getLoggerRRR&tBILINEARtBICUBICtSPLINE16tSPLINE36tHANNINGtHAMMINGtHERMITEtKAISERtQUADRICtCATROMtGAUSSIANtBESSELtMITCHELLtSINCtLANCZOStBLACKMANRUtsetR^R4RRQRTReRhR6RR$R7RDRNRjRyRR'R(((s/lib/python2.7/site-packages/matplotlib/image.pytsr"     .                    ; - [x{=U M 5