`jN1SrSSKrSSKJr SSKrSSKrSSKrSSKJ r SSK J r \R"\ 5rSrSSjrSSjrS rS rSS jrSS jrSS jrg)zImplementations of various common operations. Including `show()` for displaying an array or with matplotlib. Most can handle a numpy array or `rasterio.Band()`. Primarily supports `$ rio insp`. N) OrderedDict) DatasetReader)guard_transformc`SSKJn U$![[4a SnUS- n[U5ef=f)zKimport matplotlib.pyplot raise import error if matplotlib is not installed rNzCould not import matplotlib z*matplotlib required for plotting functions)matplotlib.pyplotpyplot ImportError RuntimeError)pltmsgs P/var/www/html/Sattelite-Image/venv/lib/python3.13/site-packages/rasterio/plot.pyget_pltrs>'  &- ;;#s #-c  [5n [U[5(aUUSRUS5n [ U R 5S:a [ U 5n U(a[US5U S'GO^[U[5(aU(a[U5U S'URS::aURSSS9n GO[[URUR55n [RR nUR"UR$UR&4Vs/sHnXPM nnURUSS9n [ U 5n O}UR*S:a[,R.R1U5nUR*S:a U=(d S n[ XS S 2S S 245n OUn U(aU(a[X5U S'U (aU(a [3X5n OU R*S:Xa [5U 5n OfU R*S:aV[7U 5R9[,R:5n [=U 5Hunn[5U5U U'M [ U 5n S nU(dSnU R?5nU(aS U ;aU RAS S5U S 'U RASS5U S'U RASS5U S'URB"U 4SS0U D6nUc [ESSS9nU(aURF"U40UD6 OURH"U 40U D6 U(aURKUSS9 U(aU RM5 U$s snf![(a U=(d SnURUSS9n GN9f=f)aDisplay a raster or raster band using matplotlib. Parameters ---------- source : array or dataset object opened in 'r' mode or Band or tuple(dataset, bidx) If Band or tuple (dataset, bidx), display the selected band. If raster dataset display the rgb image as defined in the colorinterp metadata, or default to first band. with_bounds : bool (opt) Whether to change the image extent to the spatial bounds of the image, rather than pixel coordinates. Only works when source is (raster dataset, bidx) or raster dataset. contour : bool (opt) Whether to plot the raster data as contours contour_label_kws : dictionary (opt) Keyword arguments for labeling the contours, empty dictionary for no labels. indexes: list or tupel, optional, defines the color composite of bands. ax : matplotlib.axes.Axes, optional Axes to plot on, otherwise uses current axes. title : str, optional Title for the figure. transform : Affine, optional Defines the affine transform if source is an array percent_range: tuple, optional percent_range[0], the minimum value (cumulative percentage) of the histogram for histogram streching, percent_range[1], the maximum value (cumulative percentage) of the histogram for histogram streching default percent_range is set to (2, 98). adjust : bool If the plotted data is an RGB image, adjust the values of each band so that they fall between 0 and 1 before plotting. If True, values will be adjusted by the min / max of each band. If False, no adjustment will be applied. **kwargs : key, value pairings optional These will be passed to the :func:`matplotlib.pyplot.imshow` or :func:`matplotlib.pyplot.contour` contour method depending on contour argument. Returns ------- ax : matplotlib.axes.Axes Axes with plot. rextentTmasked)rrr)rrrNFcmapcolorsred linewidthsg?alphag?originupper)fontsizeinlinebold fontweight)'r isinstancetuplereadlenshapereshape_as_imageplotting_extentrcountrzip colorinterpindexesrasterioenums ColorInterprgreenblueKeyErrorndimnpmasqueezecontrast_strech adjust_bandreshape_as_rasterastypefloat64 enumerategcagetcontourdictclabelimshow set_titleshow)source with_boundsr@contour_label_kwsr-axtitle transform percent_rangeadjustkwargsr arrsource_colorinterpr,ci rgb_indexesiibandrECs r rErE"s Z )C&%  QinnVAY' syy>Q "3'C .vay9F8  FM * * .v6F8  <<1 ++a+-C 8&1V5G5G1X%Y"&nn88 + 0A0A;CSCSTT'*Tkk+dk; #3'C ;;! UU]]6*F ;;! *G"61a-#89CC .s>F8  !#5Cxx1}!#&Q',33BJJ? )#HB)$/CG!/&s+ D  WWY  %zz(E:F8 %zz,<| **Wc2w JJs 57 5f 5  $ $a =   IIa -, - #    Uv .   IQ 8!.Ykk'$k7 8s%A(M*M8MM%NNcZ[US5(aXURRURRURRURR 4nU$U(d [ S5e[U5nURSSup4US-upVXU4-upxXWX4nU$)a!Returns an extent in the format needed for :func:`matplotlib.pyplot.imshow` (left, right, bottom, top) instead of rasterio's bounds (left, bottom, right, top) Parameters ---------- source : numpy.ndarray or dataset object opened in 'r' mode If array, data in the order rows, columns and optionally bands. If array is band order (bands in the first dimension), use arr[0] transform: Affine, required if source is array Defines the affine transform if source is an array Returns ------- tuple of float left, right, bottom, top boundsz+transform is required if source is an arrayrr)rr) hasattrrWleftrightbottomtop ValueErrorrr') rFrKrrowscolsrYr\rZr[s r r)r)s$vx  --$$fmm&9&9--&& (9(9; M 9; ;$I. \\!A& & !4L0 v+ McJ[RRU/SQ5nU$)a7Returns the source array reshaped into the order expected by image processing and visualization software (matplotlib, scikit-image, etc) by swapping the axes order from (bands, rows, columns) to (rows, columns, bands) Parameters ---------- arr : array-like of shape (bands, rows, columns) image to reshape )rrr)r5r6 transposerOims r r(r(s i (B Ir`c8[R"U/SQ5nU$)zReturns the array in a raster order by swapping the axes order from (rows, columns, bands) to (bands, rows, columns) Parameters ---------- arr : array-like in the image form of (rows, columns, bands) image to reshape )rrr)r5rbrcs r r:r:s c9 %B Ir`c [5n[U[5(aURUS9n O>[U[[ R 45(aUSRUSUS9n OUn Uc,[R"U 5[R"U 54n[U R5S:Xa3[R"U R5S5Rn S/n O-U RU RSS5Rn /SQn U RS[U 5:auU RS[U 5- n U R![R"R%UR'S 5"[R("SSU 5555 OU SU RSn U(aUn Op[U[[ R 45(a[+US5/n O;[,R."[U 55V s/sHn [+U S-5PM n n U(aS nOS nUR15nUR35nUR4"U 4XXS .UD6 UR7S S9 UR9USS9 UR;S 5 UR=S5 UR?S5 U(aURA5 ggs sn f)a Easily display a histogram with matplotlib. Parameters ---------- source : array or dataset object opened in 'r' mode or Band or tuple(dataset, bidx) Input data to display. The first three arrays in multi-dimensional arrays are plotted as red, green, and blue. bins : int, optional Compute histogram across N bins. masked : bool, optional When working with a `rasterio.Band()` object, specifies if the data should be masked on read. title : str, optional Title for the figure. ax : matplotlib.axes.Axes, optional The raster will be added to this axes if passed. label : str, optional String, or list of strings. If passed, matplotlib will use this label list. Otherwise, a default label list will be automatically created range : list, optional List of `[min, max]` values. If passed, matplotlib will use this range. Otherwise, a default range will be automatically created **kwargs : optional keyword arguments These will be passed to the :meth:`matplotlib.axes.Axes.hist` method. rrrNrgold)rr1r2violetrg saddlebrownAccentFT)binscolorlabelrangez upper right)locr r!DN Frequency)!rr#rr%r$r.Bandr5nanminnanmaxr&r' expand_dimsflattenTreshapeextendndarraytolistget_cmaplinspacestrbuiltinsror> get_figurehistlegendrDgrid set_xlabel set_ylabelrE)rFrlrrJrIrnrorNr rOrnlabelsirEfigs r show_histrs<H )C&-((kkk( FUHMM2 3 3QinnVAYvn6 } # #. 399~nnS[[]A.00kk#))A,+--J  yy}s6{" IIbMCK ' bjj'' X(>r{{1aQR?S(TUV2'  fuhmm4 5 5&)n%F*2..S*BC*BQc!a%j*BFC  WWY --/CGGCNdNvNII-I LL6L*GGDMMM$MM+    #DsK c[R"[R"U5USUS45nXS- USUS- - n[R"USS5nU$)a Histogram streching for better image visualization. Parameters ---------- arr : array-like in the image form of (rows, columns, bands) image to reshape percent_range: tuple, optional percent_range[0], the minimum values (cumulative percentage) of the histogram for histogram streching, percent_range[1], the maximum value (cumulative percentage) of the histogram for histogram streching default percent_range is set to (2, 98). rr)r5 nanpercentilearrayclip)rOrLarr_hists r r8r8Ssc a0@-PQBR/STH ! x{8A;6 7C ''#q! C Jr`c[R"[R"U55n[R"[R"U55nX- X2- - $)a5Adjust a band to be between 0 and 1. Parameters ---------- band : array, shape (height, width) A band of a raster object. kind : str An unused option. For now, there is only one option ('linear'). Returns ------- band_normed : array, shape (height, width) An adjusted version of the input band. )r5r<rtru)rTkindiminimaxs r r9r9fs? ::biio &D ::biio &D KDK ((r`) TFNNNNNNT)N) T HistogramNNN))g@gX@)__doc__r collectionsrloggingnumpyr5r. rasterio.iorrasterio.transformr getLogger__name__loggerrrEr)r(r:rr8r9r`r rs|#%.   8 $ SWIMK\D" "    ^B&)r`