9i*SrSSKrSSKrSSKrSSKJr SSKJrJ r SSK J r SSK J r S r\"\ 5SS j5rS rS rS rg)z Adapted from "Contrast Limited Adaptive Histogram Equalization" by Karel Zuiderveld, Graphics Gems IV, Academic Press, 1994. http://tog.acm.org/resources/GraphicsGems/ Relicensed with permission of the author under the Modified BSD license. N)_supported_float_type) adapt_rgb hsv_value)rescale_intensity) img_as_uinti@c [UR5n[U5n[R"[ US[ S- 4S95R[R"[ 55nUc4[URVs/sHn[US-S5PM sn5nOW[U[R5(aU4UR-nO'[!U5UR:wa[#SU35eUVs/sHn[%U5PM nn['XX#5nURUSS9n[ U5$s snfs snf)aNContrast Limited Adaptive Histogram Equalization (CLAHE). An algorithm for local contrast enhancement, that uses histograms computed over different tile regions of the image. Local details can therefore be enhanced even in regions that are darker or lighter than most of the image. Parameters ---------- image : (M[, ...][, C]) ndarray Input image. kernel_size : int or array_like, optional Defines the shape of contextual regions used in the algorithm. If iterable is passed, it must have the same number of elements as ``image.ndim`` (without color channel). If integer, it is broadcasted to each `image` dimension. By default, ``kernel_size`` is 1/8 of ``image`` height by 1/8 of its width. clip_limit : float, optional Clipping limit, normalized between 0 and 1 (higher values give more contrast). nbins : int, optional Number of gray bins for histogram ("data range"). Returns ------- out : (M[, ...][, C]) ndarray Equalized image with float64 dtype. See Also -------- equalize_hist, rescale_intensity Notes ----- * For color images, the following steps are performed: - The image is converted to HSV color space - The CLAHE algorithm is run on the V (Value) channel - The image is converted back to RGB space and returned * For RGBA images, the original alpha channel is removed. .. versionchanged:: 0.17 The values returned by this function are slightly shifted upwards because of an internal change in rounding behavior. References ---------- .. [1] http://tog.acm.org/resources/GraphicsGems/ .. [2] https://en.wikipedia.org/wiki/CLAHE#CLAHE rr) out_rangez"Incorrect value of `kernel_size`: F)copy)rdtyper nproundr NR_OF_GRAYastypemin_scalar_typetupleshapemax isinstancenumbersNumberndimlen ValueErrorint_clahe)image kernel_size clip_limitnbins float_dtypesks [/var/www/html/land-doc-ocr/venv/lib/python3.13/site-packages/skimage/exposure/_adapthist.pyequalize_adapthistr'sf( 4K  E HH&uJN8KL M T T :& EU[[A[Sa^[AB K 0 0"nuzz1 [ UZZ '=k]KLL#./;a3q6;K/ 5z 9E LL5L 1E U ##B 0s D?Ec (URnURnUVs/sHofS-PM nn[XR5VVs/sH2uphXhU-- U-[ [ R "US- 55-PM4 n nn[ R"U[Xy5V V s/sHupX/PM sn n SS9nS[U--n [ R"[[ R"[5S9n X-n Xn[URU5VVs/sHup[ X- 5S- PM nnn[ R"X/5RR5n[ R"[ R"SUS-S5[ R"SUS-S5/5R5n[X5VVs/sHunn[US-US-UU--5PM nnnU[U5R!U5n[ R""UUS9nURnUR![$R&"U5S 45n[$R&"U5nUS :a%[ [ R("UU-SS 55nOUn[ R*"[ R,S UUS 9n[ R*"[.S UUS 9n[1US[S- U5nUR!US US-5n[ R"U[3U5Vs/sHnSS/PM snSS//-SS9n[URU5VVs/sHup[ X- 5PM nnn[ R"UU/5RR5n[ R"[ R"SUS-S5[ R"SUS-S5/5R5nUR!U5n[ R""UUS9nURn[ R "U[$R&"U5[$R&"URUS 545n[ R4"[US S S 2Vs/sHn[ R"U5U- PM sn5SS06nUV s/sH'n [ R""U 5R5PM) nn [7U5V!V s/sH un!n SU - PM n"n!n [ R8"UR[ R:S9n#[7[ R<"S/U-65Hun$n%U[[U%U5V&Vs/sHun&n[U&U&U-5PM snn&5n'U'R![$R&"U5S 45n'[ R>"U'US S9n([ R&"[7U%S S S 25V)V&s/sHun)n&U"U/U&U)PM sn&n)S5n*U#U(U*-RAU#R5- n#M U#RAU5n#U#R!U5n#[ R"[ R"SU5[ R"XDS-5/5RR5n+[ R""U#U+S9n#U#R!UR5n#[[XyUR5V V Vs/sHupn[XU - 5PM snn n 5n,U#U,n#U#$s snfs snnfs sn n fs snnfs snnfs snfs snnfs snfs sn fs sn n!fs snn&fs sn&n)fs snn n f)aContrast Limited Adaptive Histogram Equalization. Parameters ---------- image : (M[, ...]) ndarray Input image. kernel_size : int or N-tuple of int Defines the shape of contextual regions used in the algorithm. clip_limit : float Normalized clipping limit between 0 and 1 (higher values give more contrast). nbins : int Number of gray bins for histogram ("data range"). Returns ------- out : (M[, ...]) ndarray Equalized image. The number of "effective" graylevels in the output image is set by `nbins`; selecting a small value (e.g. 128) speeds up processing and still produces an output image of good quality. A clip limit of 0 or larger than or equal to 1 results in standard (non-contrast limited) AHE. rg@reflect)moder)rr)axesgN) minlength)r!)r,edgeindexingijaxis)!rrziprrrceilpadrarangerarrayTflattenslicerreshape transposemathprodclipapply_along_axisbincountclip_histogram map_histogramrangemeshgrid enumeratezerosfloat32ndindextake_along_axisr)-rr r!r"rrr%pad_start_per_dimr$pad_end_per_dimp_ip_fbin_sizelutns_histhist_blocks_shapehist_blocks_axis_ordern hist_slices hist_blockshist_block_assembled_shapekernel_elementsclimhist_ map_arrayns_proc blocks_shapeblocks_axis_orderblocksblocks_flattened_shapecoeffscdim inv_coeffsresultiedger.e edge_maps edge_mappedd edge_coeffsblocks_axis_rebuild_order unpad_slicess- r&rr^s~2 ::D KKE *55Aa5 [[11DA Ua#bgga#g.//1 FF $'(9$KL$K#$KL  E:&&H ))Jb&8&8&D ECC JE+.ekk;*GH*G$!s15zA~*GGH'!78::BBDXX 1dQh "BIIa1$=> gi>A=VW=VTQ5aa!a%0=VKWk*+334EFK,,{1GHK!,!2!2%%tyy'92&>?Kii ,OC277:7DAB  r{{B u MD  ~r4D ID q*q./ BD <<25D9EA BDteDk:kq!fk:q!fXEFSI'*%++{&CD&Cdas15z&CGD88Wk2355==?L 1dQh "BIIa1$=> gi]]< (F \\&'8 9F#\\ ZZ7!3TYYv||DE?R5S T UF[[ +dd*;<*;Q ! q *;< =HLF28 8Abll1o%%'F 8&/&78&7FC!a%&7J8XXfll"** 5F qcDj!:; teT7AS$TASAU1a!e_AS$TUV %%tyy'92&>? ((FD gg4=d4R4j4I J4IDAqj& !! $Q '4I JA  ;,44V\\BB<]]5 !F^^2 3F " 1d RYYtAX67!a \\&'@ AF ^^EKK (F ##4u{{S S ! #3w S L L !F MY6 MI X(;E= 88 %U K" sM] 9] ] ]%] "]& ]+#]1 .]6];^ ^ ^ c~X:nXnUR5URU-- nXU'X@R-nX- nX:nX@URU--nX==U- ss'[R"X:X:5nXn XIR5U RU-- - nXU'US:aUn [ UR5Hdn X:n [ S[R "U 5U-5n XSU 2n X SU 2U ==S- ss'U[R "U 5-nUS::dMd O X:XaU$US:aMU$)aPerform clipping of the histogram and redistribution of bins. The histogram is clipped and the number of excess pixels is counted. Afterwards the excess pixels are equally redistributed across the whole histogram (providing the bin count is smaller than the cliplimit). Parameters ---------- hist : ndarray Histogram array. clip_limit : int Maximum allowed bin count. Returns ------- hist : ndarray Clipped histogram. rrN)sumsizer logical_andrDr count_nonzero)rZr! excess_maskexcessn_excessbin_incrupperlow_maskmid_maskmid prev_n_excessindex under_mask step_sizes r&rBrBsa(#K  Fzz|fkkJ66H"99$H  !E|H X##h..HNhN~~dmT->?H .C  CHHz111HN Q, 499%E*JAr// ;xGHI#$49$45J ! ! ": .! 3 . ((4 4H1}&  $  K Q, Kc[R"USS9R[5nXBU- U- -nXA- n[R"USX$S9 UR[ 5$)aCalculate the equalized lookup table (mapping). It does so by cumulating the input histogram. Histogram bins are assumed to be represented by the last array dimension. Parameters ---------- hist : ndarray Clipped histogram. min_val : int Minimum value for mapping. max_val : int Maximum value for mapping. n_pixels : int Number of pixels in the region. Returns ------- out : ndarray Mapped intensity LUT. r,r1N)a_mina_maxout)rcumsumrfloatr?r)rZmin_valmax_valn_pixelsrs r&rCrC"sV, ))Dr " ) )% 0Cg  ))CNCGGCt74 ::c?r)Ng{Gz?)__doc__r=rnumpyr _shared.utilsrcolor.adapt_rgbrrexposurerutilr rr'rrBrCrr&rsT 12'   9C$C$LK\3lr