hSrSSKrSSKrSSKrSSKJr SSKrSSKrSSK r SSK r SSK r SSK JrJr SSK Jr SSK7 SSKJr SSKJr SSKJr SSKJr SSKJrJrJ r J!r!J"r"J#r#J$r$ \RJ"\&5r'0S \RP_S \RP_S \RP_S \RR_S \RT_S\RV_S\RX_S\RZ_S\R\_S\R^_S\R`_S\Rb_S\Rd_S\Rf_S\Rh_S\Rj_S\Rl_\Rn\Rp\RPS.Er9\:"\95r;S3Sjr<S4Sjr=SSS.Sjr>S r?"S!S"\R5rA"S#S$\A5rB"S%S&\B5rC"S'S(\B5rD"S)S*\A5rE"S+S,\A5rFS4S-jrGS5SSS..S/jjrHS0rIS1rJS6S2jrKg)7zR The image module supports basic image loading, rescaling and display operations. N)Path)_apicbook)_image)*)FigureCanvasBase)Affine2DBboxBaseBbox BboxTransformBboxTransformToIdentityTransformTransformedBboxautononenearestbilinearbicubicspline16spline36hanninghamminghermitekaiserquadriccatromgaussianbesselmitchellsinc)lanczosblackman antialiasedc [U5S:Xa&[R"S[RS9SS4$/n/nUHnUR X5upgpUcMXr-nX-nUR XgXR 545 UR [Xx/XvRS-XRS-//55 M [U5S:Xa&[R"S[RS9SS4$[R"U5n [R"[U R5[U R5S4[RS9n UH^upgp[5RXzR - XR"- 5n [$R&"XkU [$R(SU S9 M` XR U- U R"U- 4$)a 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` magnification : float, default: 1 The additional magnification to apply for the renderer in use. Returns ------- image : (M, N, 4) `numpy.uint8` array The composited RGBA image. offset_x, offset_y : float The (left, bottom) offset where the composited image should be placed in the output figure. r)rrdtyper%Fresamplealpha)lennpemptyuint8 make_imageappend_get_scalar_alphar shapeunionzerosintheightwidthr translatex0y0rr*NEAREST) imagesrenderer magnificationpartsbboxesimagedataxytransbboxoutputr+s B/var/www/html/env/lib/python3.13/site-packages/matplotlib/image.pycomposite_imagesrJ<s4 6{axx 2Aq88 E F!,,XE   A A LL$1&=&=&?@ A MMqfq::a=0!jjm2CDEF H  5zQxx 2Aq88 ::f D XX T[[ 3tzz?A.bhh@F# $$Q[!gg+>eV^^!&e 5# 77]*DGGm,C CCc^^^^ [SU55nUbUOTR5nU(dU(dUHnURT5 M g/mTR5m UU UU4SjnUHn[ U[ 5(aRUR 5(a=UR5(a(UR5(dTRU5 MjU"5 URT5 M U"5 g)z 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. c3B# UHn[U[5v M g7fN) isinstance _ImageBase.0rDs rI 0_draw_list_compositing_images..~s@1Z:..sNc>[T5S:XaTSRT5 O[T5S:a[TTT5upnURS:waTR 5nUR TR 5 URTR55 TRU[U5[U5U5 UR5 TSS2 g)Nr(r) r,drawrJsizenew_gcset_clip_rectanglerG set_clip_path get_clip_path draw_imageroundrestore)rClbgc image_groupmagparentr>s rI flush_images3_draw_list_compositing_images..flush_imagess;1$A##H-[!A%-k8SI 99>!*B))&++6$$V%9%9%;<''E!HeAhEJJLArK) anyoption_image_nocompositerVget_image_magnificationrOrP can_composite get_clip_onr[r1) r>rdartistssuppress_composite has_images not_compositearerbrcs `` @@rI_draw_list_compositing_imagesrqts@@@J,>+I'";;=JA FF8  ..0  A1j))aoo.?.?MMOOAOO,=,=""1%x  rKr(r)c SnURSS:a{[R"URSS95 [ [ R "URSS- 55nUSS2SSU24n[5RUS5U-nURSS:a{[R"URS S95 [ [ R "URSS- 55nUSSU2SS24n[5RSU5U-nUR5nUS ;Ga*[ R"SS/URSURS//5n URU 5n [ R"[ R"U SS2S455n [ R"[ R"U SS2S455n U S URS-:d(XRS:XdU S URS-:XaAU S URS-:d(XRS:XdU S URS-:XaS nOSn[ R"X!RS S-UR5n UcUR!5n["R$"XU[&UUUUR)5UR+55 U $)z Convenience wrapper around `._image.resample` to resample *data* to *out_shape* (with a third dimension if *data* is RGBA) that takes care of allocating the output array and fetching the relevant properties from the Image object *image_obj*. zData with more than {n} cannot be accurately displayed. Downsampling to less than {n} before displaying. To remove this warning, manually downsample your data.r(iz 2**23 columns)nNriz 2**24 rowsr#rrr)r3warningswarnformatr6r-ceilr scaleget_interpolationarray transformabsdiffr5r' get_resamplerr* _interpd_get_filternorm get_filterrad) image_objrC out_shaper~r*r+msgstep interpolationposdispdispxdispyouts rI _resamplerso DC zz!}u cjj?j342774::a=5012AvvIJ$$T1- 9  zz!}u cjj?@""3'rwwtAqDz*+rwwtAqDz*+ QA& &A&TZZ]** QA& &A&TZZ]**%M%M ((9zz!"~-tzz :C))+ OODym,,,.++- / JrKc[R"URSURSS4URS9nXSS2SS2SS24'UR[R:XaSUSS2SS2S4'U$SUSS2SS2S4'U$) zP Convert an RGB image to RGBA, as required by the image resample C++ extension. rr(r%r&Nru?)r-r5r3r'r/)Argbas rI _rgb_to_rgbars| 88QWWQZQ/qww ?DArrN zzRXXQ1W  KQ1W KrKc.^\rSrSrSrSrS#SS.U4SjjjrSrU4SjrS r S r S r S r U4S jr S$SjrS%SjrSr\R$S5rSrSr\S5rSrSrSrSrSrSrSrSrSr Sr!Sr"S r#S!r$S"r%U=r&$)&rPa Base class for images. 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 rN)interpolation_stagec  >[T U]URX#U55 Uc[RSn[ R "SS/US9 X`lURU5 URU5 URU5 URU 5 URU 5 Xl SUlURU 5 g)N image.originupperlowerorigin)super__init___get_colorizermplrcParamsr check_in_listrset_filternorm set_filterradset_interpolationset_interpolation_stage set_resampleaxes_imcache_internal_update) selfaxcmapnorm colorizerrr filternorm filterradr*rkwargs __class__s rIr_ImageBase.__init__s ,,TCD >\\.1F GW-f=  J' 9% }- $$%89 (#   f%rKcUR5n[U5RSU<S3$![a [U5Rs$f=f)Nz(shape=)) get_shapetype__name__ RuntimeError)rr3s rI__str___ImageBase.__str__sP 'NN$E4j))*'%!< < ':&& & 's+.AAc,>0[TU]5ESS0E$)Nr)r __getstate__rrs rIr_ImageBase.__getstate__s;%'&(;*d;;rKc(UR5SS$)z9Return the size of the image as tuple (numrows, numcols).Nrv)rrs rIget_size_ImageBase.get_size"s~~##rKc^URc [S5eURR$)zF Return the shape of the image as tuple (numrows, numcols, channels). "You must first set the image array)_Arr3rs rIr_ImageBase.get_shape&s' 77?CD Dww}}rKc[RRX5 [R"U5S;a [ S5eSUlg)z Set the alpha value used for blending - not supported on all backends. Parameters ---------- alpha : float or 2D array-like or None )rrvz5alpha must be a float, two-dimensional array, or NoneN)martistArtist_set_alpha_for_arrayr-ndim TypeErrorr)rr+s rI set_alpha_ImageBase.set_alpha/s? ++D8 775> '-. . rKcURb$[R"UR5S:aS$UR$)am Get a scalar alpha value to be applied to the artist as a whole. If the alpha value is a matrix, the method returns 1.0 because pixels have individual alpha values (see `~._ImageBase._make_image` for details). If the alpha value is a scalar, the method returns said value to be applied to the artist as a whole because pixels do not have individual alpha values. rr)_alphar-rrs rIr2_ImageBase._get_scalar_alpha=s5kk)RWWT[[-AA-Es  rKc0>SUl[TU] 5 g)zE Call this whenever the mappable is changed so observers can update. N)rrchangedrs rIr_ImageBase.changedJs  rKc Uc [S5eURS:Xa [S5e[R"X45nUcgURU-n UR U-n U S:XdU S:XagUR S:Xa9[5RSURS*5RSS5n O [5n U [5RURURS- UR URS- 5RURUR5UR5-- n U [5RUR*UR*5RU5-n U(dU R(awU(apU S -S :wd U S -S :wa^[ R""U 5n [ R""U 5nX- U - nX- U - nU [5RS U-S U-5- n O[%U 5n [%U 5nX4nU(GdUR&S :Xd<UR&S :XaURSS ;d[)SURS35eUR*nUS;a[,R."SS/URSURS//5nU R1U5n[,R2"[,R4"USS2S455URS- n[,R2"[,R4"USS2S455URS- nUS :dUS :aSnOSnUR&S :XGaUS:XGa{UR6R8S:Xa~[,R6"UR6R:S:aSOS5nUR:UR6R::a'[<R>"SUR6SUS35 OIURA5RCS5URE5RCS5- nUS:aSOSn[GXRCU5UU 5n[IURJ[LRN5(aURCUR65nURPRUR:XaX[,RR"URP[,RT"[,RV5[,RT"S55O$[,RX"U[,RT5n[GUUUU SS9nA[,RZ"U5nSUU'UR]5nUb*[,R&"U5S:aUUUUU SS9-n[,R^RaUU5nURKU5nGOjUR&S :Xa,URJRcU5 UReU5nUR]5nUceURS S :Xa#UR6[,Rf:XaSOS n O[GXSUU 5n [GU[iUSSS 245UU 5nO[,R&"U5S:a-[GUUUU 5n [GU[iUSSS 245UU 5nOjURS S :Xa&UR6[,Rf:XaSU-OUn O[GXSUU 5U-n [GU[iUSSS 245UU 5nU US'UReUSS S!9nUR&S :XaDURk5nUSS2SS2S 4n!U!RC[,RT5W-U-U!SS&GOYURlc#UReUSUR&S :HS!9Ul6URln[oXKRq55Rs5n"U[%[AU"RtS55[%[EU"RvS-URS552[%[AU"RxS55[%[EU"RzS-URS5524n[5R[%[AU"RxS55[%[AU"RtS555U -n UURURU 4$)"a Normalize, rescale, and colormap 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. Parameters ---------- A : ndarray - a (M, N) array interpreted as scalar (greyscale) image, with one of the dtypes `~numpy.float32`, `~numpy.float64`, `~numpy.float128`, `~numpy.uint16` or `~numpy.uint8`. - (M, N, 4) RGBA image with a dtype of `~numpy.float32`, `~numpy.float64`, `~numpy.float128`, or `~numpy.uint8`. in_bbox : `~matplotlib.transforms.Bbox` out_bbox : `~matplotlib.transforms.Bbox` clip_bbox : `~matplotlib.transforms.Bbox` magnification : float, default: 1 unsampled : bool, default: False If True, the image will not be scaled, but an appropriate affine transformation will be returned instead. round_to_pixel_border : bool, default: True If 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 if exact scaling is needed, such as for `.FigureImage`. Returns ------- image : (M, N, 4) `numpy.uint8` array The RGBA image, resampled unless *unsampled* is True. x, y : float The upper left corner where the image should be drawn, in pixel space. trans : `~matplotlib.transforms.Affine2D` The affine transformation from image to pixel space. Nz9You must first set the image array or the image attributerzk_make_image must get a non-empty image. Your Artist's draw method must filter before this method is called.)NrrNrr(rrvrurur%Invalid shape  for image datartrrCfr%f8f4zCasting input data from z to z for imshow.gחAT)r*r).ru.Fbytesr)>rrWr intersectionr8r7rr r9r3r{rr:r; get_transform is_affinemathrzr6r ValueError_interpolation_stager-r}r~rrr'kinditemsizer warn_externalmaxastypeminrrOrmcolorsNoNormmaskwherefloat32nan ones_likeisnan get_alphama masked_arrayautoscale_Noneto_rgbar/rr2rrinvertedfrozenyminymaxxminxmax)#rrin_bboxout_bbox clip_bboxr? unsampledround_to_pixel_border clipped_bboxout_width_baseout_height_baset0t out_width out_height extra_width extra_heightrrrrrr scaled_dtypeda A_resampledr out_alphaout_maskr+resampled_maskedrH output_alpha alpha_channelsubsets# rI _make_image_ImageBase._make_imageQs\ 9 >? ? 66Q; 89 9((=  #%++m;&-- = Q /Q"6# ;;' !%%a!''!*5;;ArBB"$B J U  *+-Ywzz7:: .  "  # $ LOO+loo-=>}%' 0E#%,#0E0L .1I?3J$5GK&8OKL !!# "3S<5GH HAN+I_-J+ FFaK166Q;1772;&3H >!''/!JKK#'";"; "&==hhAQWWQZ(@AB{{3'rwwtAqDz23aggaj@rwwtAqDz23aggaj@AI519*0'*0'vv{2f< 77<<3&#%88AGG4D4Dq4HDd#SL#,,qww/?/??**-EaggY-1,|,MN -t0DDB+-84L(hh|.DiQRS dii88"-"4"4QWW"=K66<<1772BFF);RZZ]K\\!RZZ8 &dD)QN 88I.&' (#($!);4 1t!TTI#%55#5#5k8#L #3466Q;II,,Q/ QA(=wwqzQ./gg.Ass '0 F)Y(; &l1S"1"W:6 1FFWWU^a'#,T5)Q#GL&l1S"1"W:6 1FFwwqzQ892888Ke QV '0y)Q'ORW'W &l1S"1"W:6 1FF!-v\\&5\AFvv{..0 &q!Qw !((4y@5Ha }}$ $ Qd!&&A+ O ]]F%Y >EEGFC Q'(C aa9:;C Q'(C aa9:;;r?rs rIr0_ImageBase.make_image-s$""LMMrKcg)zd Return whether the image is better to be drawn unsampled. The derived class needs to override it. Frs rI_check_unsampled_image!_ImageBase._check_unsampled_imageAs rKcvUR5(dSUlgUR5RS:XaSUlgUR 5nUR U5 UR UR55 URUR55 URUR55 UR5(aUR5(aUR5R(aaUR!USS9up4pVUbJ[#5R%UR&SUR&S5U-nUR)X$XSU5 O7UR!XR+55up4pVUbUR)X$XS5 UR-5 SUlg)NFrTrr() get_visiblestale get_arrayrWrX _set_gc_cliprr2set_urlget_urlset_gidget_gidoption_scale_imager"rrr0r r{r3r\rir^)rr>raimr_r`rFs rIrV_ImageBase.drawIsY!!DJ  >>  A %DJ  __  " T++-. 4<<>" 4<<>"  ' ' ) )//11&&(22"ooh$oGOB1~ ((!bhhqkBUJ##B1%8"oo::<>OB1~##B11  rKcURU5(d#URRU5S(dS04$UR5R 5nUR UR UR/5up4UR5upVpxUSL=(a* X5- X6- -S:*=(a USL=(a XG- XH- -S:*n U 04$)7Test whether the mouse event occurred within the image.rFN) _different_canvasrcontainsrrr~rDrE get_extent) r mouseeventrFrDrErrrrinsides rIr4_ImageBase.containshs  " ": . .yy))*5a8"9  ""$--/ jll;<!%!2D4-EQX!($;q$@EtmE)*ah(?1(D rzrKcURURS:XaURSSS2O URSSS9n[RR U5R USS9 g)z$Write the image to png file *fname*.rNrTrpng)ry)rrrPILImage fromarraysave)rfnamer/s rI write_png_ImageBase.write_pngzs[ \\4;;'+A$''$B$-tww $41 B$$U5$9rKcL[R"USS9nUR[R:waD[R "UR[ S5(d[SURS35eURS:Xa$URSS:XaURS5nURS :Xd<URS:XaURSS ;d[S URS 35eURS:XGa[R"UR[R5(aS OSnUR5S:dXR5:aK[R!SUR5UR55 [R""USU5nUR[R:waS[R"UR[R5(aUR%[R5nU$)zd Check validity of image-like input *A* and normalize it to a format suitable for Image subclasses. T)copy same_kindzImage data of dtype z cannot be converted to floatrurr(rvrrrrrzClipping input data to the valid range for imshow with RGB data ([0..1] for floats or [0..255] for integers). Got range [%s..%s].)rsafe_masked_invalidr'r-r/can_castfloatrrr3squeeze issubdtypeintegerrr_logwarningclipr)rhighs rI_normalize_image_array!_ImageBase._normalize_image_arrays{  % %ad 3 77bhh r{{177E;'O'O2177)<123 3 66Q;1772;!+ " A! qvv{qwwr{f/DnQWWI_EF F 66Q; --<<3!Duuw{dUUWn *EEGQUUW  GGAq$'ww"(("r}}QWWbjj'I'IHHRXX&rKc[U[RR5(a [U5nUR U5UlSUlSUlg)z Set the image array. Note that this function does *not* update the normalization used. Parameters ---------- A : array-like or `PIL.Image.Image` NT)rOr;r< pil_to_arrayrOrrr'rrs rIset_data_ImageBase.set_datasB a ) )QA--a0  rKc&URU5 g)zd Retained for backwards compatibility - use set_data instead. Parameters ---------- A : array-like N)rTrSs rI set_array_ImageBase.set_arrays arKcUR$)a Return the interpolation method the image uses when resizing. One of 'auto', 'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', or 'none'. )_interpolationrs rIr|_ImageBase.get_interpolations"""rKc[R"US5R5n[R"[ US9 XlSUlg)a Set the interpolation method the image uses when resizing. If None, use :rc:`image.interpolation`. 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. Parameters ---------- s : {'auto', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} or None zimage.interpolationrTN)r _val_or_rcrrrinterpolations_namesrZr'rss rIr_ImageBase.set_interpolations< NN13 4 : : < /qA rKcUR$)za Return when interpolation happens during the transform to RGBA. One of 'data', 'rgba', 'auto'. )rrs rIget_interpolation_stage"_ImageBase.get_interpolation_stages (((rKcz[R"US5n[R"/SQUS9 XlSUlg)aa Set when interpolation happens during the transform to RGBA. Parameters ---------- s : {'data', 'rgba', 'auto'} or None Whether to apply up/downsampling interpolation in data or RGBA space. If None, use :rc:`image.interpolation_stage`. If 'auto' we will check upsampling rate and if less than 3 then use 'rgba', otherwise use 'data'. zimage.interpolation_stage)rCrr)raTN)rr^rrrr'r`s rIr"_ImageBase.set_interpolation_stages3 NN19 : 3q9$%! rKcUR5nURS:g=(a UR=(a UR$)z>Return whether the image can be composited with its neighbors.r)rrZr is_separable)rrFs rIrj_ImageBase.can_composites=""$   6 )  OO     rKcL[R"US5nXlSUlg)zv Set whether image resampling is used. Parameters ---------- v : bool or None If None, use :rc:`image.resample`. zimage.resampleTN)rr^rr')rvs rIr_ImageBase.set_resamples! NN1. / rKcUR$)z(Return whether image resampling is used.)rrs rIr_ImageBase.get_resample s ~~rKc2[U5UlSUlg)z Set whether the resize filter normalizes the weights. See help for `~.Axes.imshow`. Parameters ---------- filternorm : bool TN)bool _filternormr'rrs rIr_ImageBase.set_filternorms + rKcUR$)z8Return whether the resize filter normalizes the weights.)rrrs rIr_ImageBase.get_filternormsrKcV[U5nUS::a [S5eX lSUlg)z Set the resize filter radius only applicable to some interpolation schemes -- see help for imshow Parameters ---------- filterrad : positive float rz+The filter radius must be a positive numberTN)rGr _filterradr')rrrs rIr_ImageBase.set_filterrads- )  6JK K rKcUR$)zReturn the filterrad setting.)rxrs rIr_ImageBase.get_filterrad.s rK) rrrrxrrZrrrrr')NNNNNT@F)rFTrF)'r __module__ __qualname____firstlineno____doc__zorderrrrrrrr2rrr0r"rallow_rasterizationrVr4r@ staticmethodrOrTrWr|rrdrrjrrrrrr__static_attributes__ __classcell__rs@rIrPrPs F# &&*&&:'<$  JM;?Z;xN(   !<$: @  #()"     rKrPc r^\rSrSrSrSSSSSSSSSSS. U4SjjrSS jrSS jrS rS r S r Sr Sr U=r $) AxesImagei3a An image attached to an Axes. Parameters ---------- ax : `~matplotlib.axes.Axes` The Axes the image will belong to. cmap : str or `~matplotlib.colors.Colormap`, default: :rc:`image.cmap` The Colormap instance or registered colormap name used to map scalar data to colors. norm : str or `~matplotlib.colors.Normalize` Maps luminance to 0-1. interpolation : str, default: :rc:`image.interpolation` Supported values are 'none', 'auto', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'blackman'. interpolation_stage : {'data', 'rgba'}, default: 'data' If 'data', interpolation is carried out on the data provided by the user. If 'rgba', the interpolation is carried out after the colormapping has been applied (visual interpolation). origin : {'upper', 'lower'}, default: :rc:`image.origin` Place the [0, 0] index of the array in the upper left or lower left corner of the Axes. The convention 'upper' is typically used for matrices and images. extent : tuple, optional The 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. filternorm : bool, default: True A parameter for the antigrain image resize filter (see the antigrain documentation). If filternorm is set, the filter normalizes integer values and corrects the rounding errors. It doesn't do anything with the source floating point values, it corrects only integers according to the rule of 1.0 which means that any sum of pixel weights must be equal to 1.0. So, the filter function must produce a graph of the proper shape. filterrad : float > 0, default: 4 The filter radius for filters that have a radius parameter, i.e. when interpolation is one of: 'sinc', 'lanczos' or 'blackman'. resample : bool, default: False When True, use a full resampling method. When False, only resample when the output image is larger than the input image. **kwargs : `~matplotlib.artist.Artist` properties NTr}F) rrrrrextentrrr*rc H>Xpl[T U]"U4UUUUUUU U U S. U D6 g)N) rrrrrrrr*r)_extentrr)rrrrrrrrrrr*rrrs rIrAxesImage.__init__csD    '! 3  rKcURup#pE[R"X$X5/5nURUR 55$rN)rr from_extents transformedr)rr>r:x1r;y1rGs rIget_window_extentAxesImage.get_window_extents>  ""!12 2 2 455rKc UR5nUR5upVpx[[R"XW/Xh//55n [ X5n UR 5(a-UR5=(d URROURSS9Rn URURXU X#S9$)NTrootr%) rr5r r-r}rrk get_clip_boxrrG get_figurerr) rr>r?rrFrx2ry2rGtransformed_bboxrMs rIr0AxesImage.make_images""$*BHHrh123*47;?;K;K;M;M""$6 __$_/44  - D DrKc(UR5S:H$)z9Return whether the image would be better drawn unsampled.r)r|rs rIr" AxesImage._check_unsampled_images%%'611rKc URRSUSUS/4SUSUS/4/U5uup4upVU(a[R"SU5eURR X0R 5nURR X@R 5nURR XPR 5nURR X`R 5nX4XV/nXlX54XF44nURRU5 X4/URRSS&XV/URRSS&URR5(aURRX44SS 9 URR5(aURRXV4SS 9 S Ulg) a Set the image extent. Parameters ---------- extent : 4-tuple of float The position and size of the image as tuple ``(left, right, bottom, top)`` in data coordinates. **kwargs Other parameters from which unit info (i.e., the *xunits*, *yunits*, *zunits* (for 3D Axes), *runits* and *thetaunits* (for polar Axes) entries are applied, if present. Notes ----- This updates `.Axes.dataLim`, and, if autoscaling, sets `.Axes.viewLim` to tightly fit the image, regardless of `~.Axes.dataLim`. Autoscaling state is not changed, so a subsequent call to `.Axes.autoscale_view` will redo the autoscaling in accord with `~.Axes.dataLim`. rDrr(rErvru set_extentN)rT)r_process_unit_infor kwarg_error_validate_converted_limitsconvert_xunitsconvert_yunitsrupdate_datalim sticky_edgesrDrEget_autoscalex_onset_xlimget_autoscaley_onset_ylimr')rrrrrrrcornerss rIrAxesImage.set_extents*&*YY%A%AF1Ivay) *F1Ivay) * , &" lt ""<8 8yy33 %%'yy33 %%'yy33 %%'yy33 %%'d) , ,   )"&A"&A 99 & & ( ( II  |$  7 99 & & ( ( II  |$  7 rKcURb UR$UR5nUup#URS:Xa SUS- US- S4$SUS- SUS- 4$)6 D2.` >rKrc^\rSrSrSS.U4SjjrSrSSjrSrSrU4S jr S r S r S r U4S jr U4SjrSrSrU=r$)NonUniformImageirr]c J>[TU]"U40UD6 URU5 g)a Parameters ---------- ax : `~matplotlib.axes.Axes` The Axes the image will belong to. interpolation : {'nearest', 'bilinear'}, default: 'nearest' The interpolation scheme used in the resampling. **kwargs All other keyword arguments are identical to those of `.AxesImage`. N)rrr)rrrrrs rIrNonUniformImage.__init__s% &v& }-rKcg)z)Return False. Do not use unsampled image.Fr!rs rIr"&NonUniformImage._check_unsampled_imagesrKc URc [S5eU(a [S5eURnURS:XalUR[ R :waURUSS9nO[ R"USS2SS2[ R4SS5nSUSS2SS2S4'OUR[ R :wa"SU-R[ R 5nURSS:XaZ[ R"[/URS SQSP5[ R 5nXESS2SS2S S24'SUSS2SS2S4'UnURRR upgp[#[%U5S -[%U5S - - U-5n [#[%U 5S -[%U5S - - U-5n URR&R)5n U R+[ R,"XhU 5V s/sHoU4PM sn 5SS2S 4nU R+[ R,"XyU 5Vs/sHoU4PM sn5SS2S 4nUR.S :XGaUR0SS UR0S S-S- nUR2SS UR2S S-S- nUR5U5nUR5U5n[ R6"U5R9[ R:5R=5[ R>RAUURS -U5R9[ R 5RCXS45nGO[ RD"UR0R5U5S - S [GUR05S- 5n[ RD"UR2R5U5S - S [GUR25S- 5n[ R>RAUURS -U5n[ RD"[ RH"XR0U- [ RJ"UR05U[ RLS9S S 5n[ RD"[ RH"UUR2U- [ RJ"UR25U[ RLS9S S 5n[ R@"S U- S U- 5n[ R@"US U- 5n[ R@"S U- U5n[ R@"UU5n[ RN"XS4[ R 5n[QS5HynUSS2SS2U4RCS 5nUUU-nUUUURS SU-- nUUUS SU-- nUUUURS S -SU-- nUUSS2SS2U4'M{ UXg[S54$s sn fs snf)Nrz*unsampled not supported on NonUniformImagervTrr%rrurrr(rrr&)*rrrrr'r-r/rrepeatnewaxisrr3r5tuplerrGextentsr6r] transDatarr~linspacerZ_Ax_Ay searchsortedascontiguousarrayviewuint32raveladdouterreshaperMr,dividerrr.ranger) rr>r?rrBr_r`ryr r8r7invertedTransformrDx_pixrEy_pixx_midy_midx_inty_intr/idx_intx_fracy_fracf00f10f01f11chanacbufs rIr0NonUniformImage.make_images< 77?CD D IJ J GG 66Q;ww"(("LL$L/IIa1bjj 011a8 !Q' ww"(("UNN288,wwqzQHHU#5QWWQq\#51#56A !Q!)  !Q' YY^^++ aeAhnqC8MIJuQx#~%(S.9]JK II//88:!++[[u5 65V5 68891>!++[[v6 76V6 799:A?   ) +XXcr]TXXab\1Q6EXXcr]TXXab\1Q6E&&u-E&&u-E $$Q',,RYY7==?FFLL!3U;=bhh(: ;  GG%%e,q0!S]Q5FHEGG%%e,q0!S]Q5FHEffll51771:#5u=GWW %((5/12774883DU3K " ,1FWW %$((5/12774883DU3K " ,1F((1v:q6z2C((61v:.C((1v:v.C((66*C6!,bhh7Baq!Tz]**2.BwK'sR _W555sRVG_,,sR Q0999!$1a:!1*,,,[ 7 7s  Y  YcURU5n[R"U[R5n[R"U[R5nURURs=:XaS:Xa-O O*UR SSUR UR -:Xd [ S5eX0lXlX l SUl SUl g)aN Set the grid for the pixel centers, and the pixel values. Parameters ---------- x, y : 1D array-like Monotonic arrays of shapes (N,) and (M,), respectively, specifying pixel centers. A : array-like (M, N) `~numpy.ndarray` or masked array of values to be colormapped, or (M, N, 3) RGB array, or (M, N, 4) RGBA array. r(NrvzAxes don't match array shapeT) rOr-r}rrr3rrrrrr'rrDrErs rIrTNonUniformImage.set_dataMs  ' ' * HHQ # HHQ #!&&%A%!''"1+1779J*J:; ;  rKc[S5eNzMethod not supportedrrargss rIrWNonUniformImage.set_arraye!"899rKcL>UbUS;a [S5e[TU] U5 g)zg Parameters ---------- s : {'nearest', 'bilinear'} or None If None, use :rc:`image.interpolation`. N)rrz?Only nearest neighbor and bilinear interpolations are supported)rrr)rrars rIr!NonUniformImage.set_interpolationhs4 =Q&==%'NO O !!$rKcURc [S5eURSURSURSURS4$)NzMust set data firstrr)rrrrrs rIr5NonUniformImage.get_extenttsF 77?45 5xx{DHHRL$((1+txx|CCrKcgrNr!rss rIrNonUniformImage.set_filternormy rKcgrNr!)rrs rIrNonUniformImage.set_filterrad|rrKcT>URb [S5e[TU] U5 gNz'Cannot change colors after loading data)rrrset_norm)rrrs rIrNonUniformImage.set_norm& 77 HI I rKcT>URb [S5e[TU] U5 gr)rrrset_cmap)rrrs rIr NonUniformImage.set_cmaprrKcrURURp2X RS:d6X RS:d$X0RS:dX0RS:ag[R "URU5S- n[R "URU5S- nUR XT4$Nrrr(xdataydatarrr-rrrrrDrErrs rIrNonUniformImage.get_cursor_data{{EKK1  Oq88B</HHQK1xx|#3 OODHHa (1 , OODHHa (1 ,wwqt}rKrrrrr'r~)rrrrrr"r0rTrWrr5rrrr rrrrs@rIrrsO,5 . .H-T0: %D     rKrcd^\rSrSrSrS SSSS.U4SjjjrS SjrSrSrS r S r S r U=r $) PcolorImageiz 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. N)rrrc p>[T U]XXWS9 URU5 UbURX#U5 gg)a, Parameters ---------- ax : `~matplotlib.axes.Axes` The Axes the image will belong to. x, y : 1D array-like, optional Monotonic arrays of length N+1 and M+1, respectively, specifying rectangle boundaries. If not given, will default to ``range(N + 1)`` and ``range(M + 1)``, respectively. A : array-like The data to be color-coded. The interpretation depends on the shape: - (M, N) `~numpy.ndarray` or masked array: values to be colormapped - (M, N, 3): RGB array - (M, N, 4): RGBA array cmap : str or `~matplotlib.colors.Colormap`, default: :rc:`image.cmap` The Colormap instance or registered colormap name used to map scalar data to colors. norm : str or `~matplotlib.colors.Normalize` Maps luminance to 0-1. **kwargs : `~matplotlib.artist.Artist` properties )rrrN)rrrrT) rrrDrErrrrrrs rIrPcolorImage.__init__s>D TG f% = MM! " rKcURc [S5eU(a [S5eURc9UR URSS9n[ R "U/SQS5UlURn[R"URRR5S5n[ R"U5S-R[ R5nUS U:gR5(aU=USS /SS24'USS2SS /4'URRR upxp[#U 5S -[#U5S - - n [#U 5S -[#U5S - - n [#X-5n [#X-5n URR$n [ R&"U R(U R*U 5n[ R&"U R,U R.U 5nUR0R3U5nUR4R3U5nUR7[ R85R;5[ R<R?UUR@S -U5R7[ R5RCXS 45nUXx[E54$)Nrz&unsampled not supported on PColorImageTr)r(r(rrrconstantrrrrrr(r%)#rrrrrr-padrrpatch get_facecolorr}rr/allrGrr]viewLimrr:rr;rrrrrrrrrr3rr)rr>r?rrpadded_Abgr_r`ryr r8r7vlrrrrr/s rIr0PcolorImage.make_images$ 77?CD D EF F ==  TWWD 1AFF1&> KDM== __TYY__:: @ T"((^GGVA$67 1*,,,rKcg)NFr!rs rIr""PcolorImage._check_unsampled_imagesrKcURU5nUc'[R"SURSS-5O([R"U[ 5R 5nUc'[R"SURSS-5O([R"U[ 5R 5nURSSURS- URS- 4:wa=[SURSS<SURS- URS- 4<S35eUS US:aUSSS 2nUSS2SSS 24nUS US:aUSSS 2nUSSS 2nX0l Xl X l SUl S Ul g) a  Set the grid for the rectangle boundaries, and the data values. Parameters ---------- x, y : 1D array-like, optional Monotonic arrays of length N+1 and M+1, respectively, specifying rectangle boundaries. If not given, will default to ``range(N + 1)`` and ``range(M + 1)``, respectively. A : array-like The data to be color-coded. The interpretation depends on the shape: - (M, N) `~numpy.ndarray` or masked array: values to be colormapped - (M, N, 3): RGB array - (M, N, 4): RGBA array Nrr(rrvz"Axes don't match array shape. Got z , expected .rT)rOr-aranger3r}rGrrWrrrrrr'rs rIrTPcolorImage.set_datasR$  ' ' *-.YBIIb!''!*q. )BHHQ[T U]SUUUUS9 URU5 XPlX`lUR U5 SUlg) 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 N)rrrrr)rr set_figureoxoyrr?) rfigrrrr1r2rrrs rIrFigureImage.__init__"sT      f% rKcUR5upSUR-US- UR-SUR-US- UR-4$)rrr)rr6r7)rrrs rIr5FigureImage.get_extent?sN==?tww dgg 5tww dgg 57 7rKc URSS9nURUR- n[URU- URU- /URU- UR R S-URU- UR R S-//5nUR5upxXqR-nXR-n[SS/Xx//5n URUR XfXU- USS9$)NTrr(rF)r?rr) rdpir r6r7rr3get_size_inchesr) rr>r?rr8facrGr8r7rMs rIr0FigureImage.make_imageEsoo4o(ll377"dggck4773;/wws{TWW]]1%55ggckDGGMM!$44789++-  ,,aVe_-. GGTS5Hu > >rKc2>[TU]U5 SUlg)zSet the image array.TN)rrTr')rrrs rIrTFigureImage.set_dataWs  rK)r?r6r7r'r~) rrrrrrrZrr5r0rTrrrs@rIr0r0sB( FN!!:7 >$rKr0c \^\rSrSrSrSSSSSSSSS.U4SjjrS S jrS rSS jrS r U=r $) BboxImagei]z;The Image class whose size is determined by the given bbox.NTr}Frrrrrrrr*c F>[T U]"SUUUUUUUU S.U D6 Xlg)r4NrErN)rrrG) rrGrrrrrrrr*rrs rIrBboxImage.__init__`sC$   '!   rKcUcUR5R5n[UR[5(a UR$[ UR5(aURU5$[ S5e)NzUnknown type of bbox)r _get_rendererrOrGr callabler)rr>s rIrBboxImage.get_window_extentsb  (668H dii * *99  dii 99X& &34 4rKcURU5(dUR5(dS04$URURp2UR 5R X#5nU04$)r2F)r3r&rDrErr4)rr6rDrEr7s rIr4BboxImage.containss]  ! !* - -T5E5E5G5G"9 ||Z\\1'')2218rzrKc *UR5upEURU5R5nU=RXE/-slURU5n[ SS/XE//5n[ U5UlURURXgXUS9$)Nrr%) get_canvas_width_heightrr_pointsr r _transformrr) rr>r?rr8r7bbox_inbbox_outrMs rIr0BboxImage.make_images 88: ((299;E?*))(3aVe_-.)$/ GG ti I IrK)rQrGrNr~) rrrrrrrr4r0rrrs@rIrDrD]sAE# @ 5 I IrKrDcdSSKJn Uc[U[5(aTUR U5n[ UR 5S:aSnO[U5RR5SSnO[[US5(aSnOG[US5(a1[UR5RR5SSnOSnOUnUS:Xa[RRO[RR n[U[5(a3[ UR U5R 5S:a [#S5eU"U5n[U[RR5(a [%U5O ['U5sSSS5 $!,(df  g=f) a Read an image from a file into an array. .. note:: This function exists for historical reasons. It is recommended to use `PIL.Image.open` instead for loading images. Parameters ---------- fname : str or file-like The image file to read: a filename, a URL or a file-like object opened in read-binary mode. Passing a URL is deprecated. Please open the URL for reading and pass the result to Pillow, e.g. with ``np.array(PIL.Image.open(urllib.request.urlopen(url)))``. format : str, optional The image file format assumed for reading the data. The image is loaded as a PNG file if *format* is set to "png", if *fname* is a path or opened file with a ".png" extension, or if it is a URL. In all other cases, *format* is ignored and the format is auto-detected by `PIL.Image.open`. Returns ------- `numpy.array` The image data. The returned array has shape - (M, N) for grayscale images. - (M, N, 3) for RGB images. - (M, N, 4) for RGBA images. PNG images are returned as float arrays (0-1). All other formats are returned as int arrays, with a bit depth determined by the file's contents. r)parseNr(r:geturlnamezPlease open the URL for reading and pass the result to Pillow, e.g. with ``np.array(PIL.Image.open(urllib.request.urlopen(url)))``.)urllibrVrOstrurlparser,schemersuffixrhasattrrXr;PngImagePlugin PngImageFiler<openr_pil_png_to_float_arrayrR)r?ryrVparsedextimg_openrBs rIimreadrfsMN ~ eS ! !^^E*F6==!A%5k((..04 UH % % C UF # #uzz"))//1!"5CC+.%<''SYY^^ %#ennU&;&B&B"Ca"G I  %EeS%7%7%D%DEE(.U# s ?F!! F/)metadata pil_kwargsc SSKJn [U[R5(a[R "U5nUcN[U[ 5(a[U5RSSO[RSR5nUS;a=U b[SU35eU "USS 9n U RXX#US S 9 U RXUS US 9 gUc[RS nO[R "SUS9 US:XaUSSS2n[U["5(a6UR$S:Xa&UR&S:XaUR(SS:XaUn O5[*R,"US9n U R/X#5 U R1US S9n U c0n OU R35n U R(SU R(S4n[4R6"U SS9n [8R:R=SXSSSS5nUS:XaSU ;aU(a[R>"S5 OSS[R@S 30UbUO0En[8RBRE5=U S'nURG5HunnUcM URIUU5 M OUb[S!U<35eUS";aS#n[RS$n[JRL"US%5(a[RS&n[OS'[PRR"U555n[8R:RUS(UU5nURWX5 UnU RYS)U5 U RYS*Xw45 URZ"U40U D6 g)+ar Colormap and save an array as an image file. RGB(A) images are passed through. Single channel images will be colormapped according to *cmap* and *norm*. .. note:: If you want to save a single channel image as gray scale please use an image I/O library (such as pillow, tifffile, or imageio) directly. Parameters ---------- fname : str or path-like or file-like A path or a file-like object to store the image in. If *format* is not set, then the output format is inferred from the extension of *fname*, if any, and from :rc:`savefig.format` otherwise. If *format* is set, it determines the output format. arr : array-like The image data. The shape can be one of MxN (luminance), MxNx3 (RGB) or MxNx4 (RGBA). vmin, vmax : float, optional *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 : str or `~matplotlib.colors.Colormap`, default: :rc:`image.cmap` A Colormap instance or registered colormap name. The colormap maps scalar data to colors. It is ignored for RGB(A) data. format : str, optional The file format, e.g. 'png', 'pdf', 'svg', ... The behavior when this is unset is documented under *fname*. origin : {'upper', 'lower'}, default: :rc:`image.origin` Indicates whether the ``(0, 0)`` index of the array is in the upper left or lower left corner of the Axes. dpi : float The DPI to store in the metadata of the file. This does not affect the resolution of the output image. Depending on file format, this may be rounded to the nearest integer. metadata : dict, optional Metadata in the image file. The supported keys depend on the output format, see the documentation of the respective backends for more information. Currently only supported for "png", "pdf", "ps", "eps", and "svg". pil_kwargs : dict, optional Keyword arguments passed to `PIL.Image.Image.save`. If the 'pnginfo' key is present, it completely overrides *metadata*, including the default 'Software' key. rFigureNr(zsavefig.format)pdfpsepssvgz'Cannot use 'pil_kwargs' when saving to F)r=frameonT)rvminvmaxrresize)r=ry transparentrgr)rrrrrrrur%)rrC) requirementsRGBArawr:pnginfoz@'metadata' is overridden by the 'pnginfo' entry in 'pil_kwargs'.SoftwarezMatplotlib versionz, https://matplotlib.org/z"metadata not supported for format )jpgjpegr|zsavefig.facecolorrzfigure.facecolorc3># UHn[US-5v M g7f)rN)r6rQs rIrSimsave..fsJ0I1#a#g,,0IsRGBryr=).matplotlib.figurerkrOosPathLikefspathrZrr]rrrrfigimagesavefigrr memoryviewryrr3 mcolorizer Colorizerset_climrrCr-requirer;r< frombufferr __version__r_PngInfoitemsadd_textr _str_equalrrto_rgbnewpaste setdefaultr>)r?rrqrrrryrr=rgrhrkr8rsm pil_shaperBrykrl facecolorcolor backgrounds rIimsaversHf)%%% %  ~,6uc,B,B$u+$$QR(||$45uuw  ,,  !9&BD De, S$&   " E6t%  ' >\\.1F   1& A W dd)C sJ ' 'CJJ#,=HHMciimq&8 D%%40B KK #::c:.D  J$*JZZ]DJJqM2 zz$S1 $$ IUFAq: U?J&&&(JK#5coo5FG;"<$,#7xR 362D2D2L2L2NN 9%$NN,DAq}((A.- !A&LM M _ $F %89I 622LL);< Jy0IJJEui?J   U *Eh/ecZ0 5'J'rKcPURS;a[R"U5$URRS5(aUR SUR5nURR S5(a[R "US5nO[R "US5nURURSSS25RS 5$URS 5n[R"U5$![an[S 5UeSnAff=f) a8 Load a `PIL image`_ and return it as a numpy int array. .. _PIL image: https://pillow.readthedocs.io/en/latest/reference/Image.html Returns ------- numpy.array The array shape depends on the image type: - (M, N) for grayscale images. - (M, N, 3) for RGB images. - (M, N, 4) for RGBA images. )rwRGBXrLzI;16rxrz>u2z''/Hzz(## >34# = >s#D D% D  D%cURnURRnUS:Xa%[R"U[R 5$US:Xa$[R "US[R S9$US:Xa$[R "US[R S9$US:Xa$[R "US[R S9$US :Xa$[R "US [R S9$US :Xa$[R "US[R S9$US :Xa3[R "URS 5S[R S9$US:Xa3[R "URS 5S[R S9$US :Xa$[R "US[R S9$[SU35e)z2Convert a PIL `PNGImageFile` to a 0-1 float array.1zL;2rur&zL;4rrzI;16BirPrwLAzUnknown PIL rawmode: ) rr: im_rawmoder-rrrrr)pil_pngrrawmodes rIrbrbsP <> u}yy("**== s{yy0("**MM t|yy0("**MM v~yy("**== ,WI6 77rKc6[U5nURupgnSn Xi- U-n Xy- U-n U(aSSKJn U R X4U S9n OSSKJn U"X4U S9n [U 5 U R/SQSS//S 9nURUSS US 9 U RXS 9 U $) aW Make a thumbnail of image in *infile* with output filename *thumbfile*. See :doc:`/gallery/misc/image_thumbnail_sgskip`. Parameters ---------- infile : str or file-like The image file. Matplotlib relies on Pillow_ for image reading, and thus supports a wide range of file formats, including PNG, JPG, TIFF and others. .. _Pillow: https://python-pillow.github.io thumbfile : str or file-like The thumbnail filename. scale : float, default: 0.1 The scale factor for the thumbnail. interpolation : str, default: 'bilinear' The interpolation scheme used in the resampling. See the *interpolation* parameter of `~.Axes.imshow` for possible values. preview : bool, default: False If True, the default backend (presumably a user interface backend) will be used which will cause a figure to be raised if `~matplotlib.pyplot.show` is called. If it is False, the figure is created using `.FigureCanvasBase` and the drawing backend is selected as `.Figure.savefig` would normally do. Returns ------- `.Figure` The figure instance containing the thumbnail. drN)figsizer=rj)rrr(r(rF)aspectrpxticksyticksT)rr*r)r=) rfr3matplotlib.pyplotpyplotfigurerrkradd_axesimshowr)infile thumbfiler{rpreviewr/rowscolsdepthr=r7r8pltr8rkrs rI thumbnailrsN BD C Z% F J E'jj%cj:,e_#6 l6#Br  ;BIIb$mILKK K# JrK)rrN)NNNNNr)g?rF)Lrrrloggingpathlibrrwnumpyr- PIL.Imager;PIL.PngImagePlugin matplotlibrrrrmatplotlib._imagematplotlib.artistartistrmatplotlib.colorizerrrmatplotlib.backend_basesrmatplotlib.colorscolorsrmatplotlib.transformsr r r r r rr getLoggerrrKr<BILINEARBICUBICSPLINE16SPLINE36HANNINGHAMMINGHERMITEKAISERQUADRICCATROMGAUSSIANBESSELMITCHELLSINCLANCZOSBLACKMANrsetr_rJrqrrColorizingArtistrPrrrr0rDrfrrRrbrr!rKrIrs[  " #)5#((("  FNN  FNN v~~    v~~      v~~ v~~ v~~  fmm v~~  fmm   fmm  ! " FKK# $~~>>)  .9~5Dr7;,`<@q5p G ,,G Ty yxbibJD)DN?*?D@I @IFK%\@D~(-1d~(B $F8<;E=rK