9isVSSKrSSKrSSKrSSKrSSKrSSKJrJr /SQr Sr Sr Sr "SS 5r "S S \ 5r"S S \5r"SS\S9r"SS5rSr"SS5r"SS\ 5rSrS(SjrSrSrSrS)SjrSrSrS rS!rS"r \RB"5RDRF\RB\RH"5RDRF\RH\RJ"5RDRF\RJ\RL"5RDRF\RL\RN"5RDRF\RBS#\RHS$\RL0r(S*S%jr)S&r*S'r+g)+N) all_warningswarn) deprecate_funcget_bound_method_classr safe_as_intcheck_shape_equalitycheck_nDr reshape_ndidentity slice_at_axisdeprecate_parameter DEPRECATEDcxUnSn[US5(a$URnUS- n[US5(aM$U$)z+Count the number of wrappers around `func`.r __wrapped__r)hasattrr)func unwrappedcounts U/var/www/html/land-doc-ocr/venv/lib/python3.13/site-packages/skimage/_shared/utils.py_count_wrappersrsCI E )] + +))    )] + + Lcb[U5n[RRUR5nUR R S5Hn[X#5nM [W5nXQ- S-n[US5$![a#n[SUR SU<S35UeSnAff=f)zFind stacklevel for a warning raised from a wrapper around `func`. Try to determine the number of Parameters ---------- func : Callable Returns ------- stacklevel : int The stacklevel. Minimum of 2. .zCould not access `z` in z., may be a closure. Set stacklevel manually. Nr) rsysmodulesget __module__ __qualname__splitgetattrAttributeError RuntimeErrormax)r wrapped_countmodulename global_funcglobal_wrapped_counte stacklevels r_warning_stacklevelr-$s $D)M[[__T__ -F <%%++C0D!&/K1 /{;%59J z1   !2!2 35 C; <  s-B B. B))B.chURRURU5n[U5nU$)z"Return function call stack length.) __globals__r__name__r)r_funclengths r_get_stack_lengthr3Gs-     5E U #F Mrc"\rSrSrSr0rSrSrg)_DecoratorBaseClassNaUsed to manage decorators' warnings stacklevel. The `_stack_length` class variable is used to store the number of times a function is wrapped by a decorator. Let `stack_length` be the total number of times a decorated function is wrapped, and `stack_rank` be the rank of the decorator in the decorators stack. The stacklevel of a warning is then `stacklevel = 1 + stack_length - stack_rank`. cdURRUR[U55nU$N) _stack_lengthrr0r3)selfrr2s rget_stack_length$_DecoratorBaseClass.get_stack_length\s)##'' 7H7NO rN)r0rr __firstlineno____doc__r9r;__static_attributes__r=rrr5r5Ns Mrr5c,\rSrSrSrSS.SjrSrSrg)change_default_valueaakDecorator for changing the default value of an argument. Parameters ---------- arg_name: str The name of the argument to be updated. new_value: any The argument new value. changed_version : str The package version in which the change will be introduced. warning_msg: str Optional warning message. If None, a generic warning message is used. N) warning_msgc4XlX lX@lX0lgr8)arg_name new_valuerDchanged_version)r:rFrGrHrDs r__init__change_default_value.__init__rs "&.rc>^^^^[R"T5Rn[UR 55R TR 5mUTR Rn[T5mTRcsSTR STRSTRSTR SUSTRSTR STRS TR S 3Tl [R"T5UUUU4S j5nU$) NzThe new recommended value for z is z. Until version z, the default z value is z. From version z, the z default value will be z/. To avoid this warning, please explicitly set z value.c>STRT5-T- n[U5TS-:aBTRUR5;a$[R "TR [US9 T"U0UD6$)Nr)r,)r;lenrFkeyswarningsrrD FutureWarning)argskwargsr,arg_idxrr: stack_ranks r fixed_func1change_default_value.__call__..fixed_funcsdT22488:EJ4y7Q;&4== +M d.. *U(( (r)inspect signature parameterslistrNindexrFdefaultrrDrGrH functoolswraps)r:rrY old_valuerUrSrTs`` @@r__call__change_default_value.__call__xs &&t,77 z()// >t}}-55 $T*    #0t>>""243G3G2HI#}}oZ {C $ 4 45VDMM?K))-(8977;}}oW N     )  )r)rFrHrGrDr0rr r>r?rIr`r@r=rrrBrBas MQ/ rrBc\rSrSrSrSrSrg)PatchClassReprz5Control class representations in rendered signatures.c"SURS3$)N<>)r0)clss r__repr__PatchClassRepr.__repr__s3<<.""rr=N)r0rr r>r?rjr@r=rrrdrds ?#rrdc\rSrSrSrSrg)ra Signal value to help with deprecating parameters that use None. This is a proxy object, used to signal that a parameter has not been set. This is useful if ``None`` is already used for a different purpose or just to highlight a deprecated parameter in the signature. r=N)r0rr r>r?r@r=rrrrsrr) metaclassc>\rSrSrSr\rSrSrSSSSS.SjrS r S r g) raHDeprecate a parameter of a function. Parameters ---------- deprecated_name : str The name of the deprecated parameter. start_version : str The package version in which the warning was introduced. stop_version : str The package version in which the warning will be replaced by an error / the deprecation is completed. template : str, optional If given, this message template is used instead of the default one. new_name : str, optional If given, the default message will recommend the new parameter name and an error will be raised if the user uses both old and new names for the same parameter. modify_docstring : bool, optional If the wrapped function has a docstring, add the deprecated parameters to the "Other Parameters" section. stacklevel : int, optional This decorator attempts to detect the appropriate stacklevel for the deprecation warning automatically. If this fails, e.g., due to decorating a closure, you can set the stacklevel manually. The outermost decorator should have stacklevel 2, the next inner one stacklevel 3, etc. Notes ----- Assign `DEPRECATED` as the new default value for the deprecated parameter. This marks the status of the parameter also in the signature and rendered HTML docs. This decorator can be stacked to deprecate more than one parameter. Examples -------- >>> from skimage._shared.utils import deprecate_parameter, DEPRECATED >>> @deprecate_parameter( ... "b", new_name="c", start_version="0.1", stop_version="0.3" ... ) ... def foo(a, b=DEPRECATED, *, c=None): ... return a, c Calling ``foo(1, b=2)`` will warn with:: FutureWarning: Parameter `b` is deprecated since version 0.1 and will be removed in 0.3 (or later). To avoid this warning, please use the parameter `c` instead. For more details, see the documentation of `foo`. a Parameter `{deprecated_name}` is deprecated since version {deprecated_version} and will be removed in {changed_version} (or later). To avoid this warning, please do not use the parameter `{deprecated_name}`. For more details, see the documentation of `{func_name}`.aParameter `{deprecated_name}` is deprecated since version {deprecated_version} and will be removed in {changed_version} (or later). To avoid this warning, please use the parameter `{new_name}` instead. For more details, see the documentation of `{func_name}`.NT)templatenew_namemodify_docstringr,cXXlXPlX@lX lX0lX`lXplgr8)deprecated_namerrrq start_version stop_versionrsr,)r:rurvrwrqrrrsr,s rrIdeprecate_parameter.__init__s+ /  *( 0$rc^^^^^[R"T5Rn[UR 55R TR 5mTR(a3[UR 55R TR5mOSmUTR R[La![STR S[<S35eTRb TRnO&TRb TRnO TRnURTR TRTR TR"TRS9m[$R&"T5UUUUU4Sj5nTR((a@TR*b3[-TTR TR0TR5nXTlU$)NFz Expected `z` to have the value z2 to indicate its status in the rendered signature.)rudeprecated_versionrH func_namerrc>[n[n[U5T:a(UTnTRbUST[4-UTS-S-nTRUR 5;a/UTRnTRb[UTR'TSLa[U5T:aUTnTR(a-TRUR 5;aUTRnU[LaTR b TR O [ T5n[R"T [US9 U[La&[STRSTRS35eTRbX!TR'T"U0UD6$)NrFcategoryr,zBoth deprecated parameter `z` and new parameter `z<` are used. Use only the latter to avoid conflicting values.) rrMrrrurNr,r-rOrrP ValueError) rQrRdeprecated_valuerGr,deprecated_idxrnew_idxr:warning_messages rrU0deprecate_parameter.__call__..fixed_funcs) "I4y>)#'#7 ==,_n-%-(~1345 ##v{{}4#)$*>*>#? ==,3=F4//0e#D G(; M }}&++-!?"4==1 z12OO,T2  #m J.$5d6J6J5KL..2mm_=GH ]].,<4==)(( (r)rWrXrYrZrNr[rurrr\rr$rqreplace_parameter_templateremove_parameter_templateformatrvrwr r]r^rsr?_docstring_add_deprecated) r:rrYrqrUnewdocrrrs `` @@@rr`deprecate_parameter.__call__s&&t,77 joo/066t7K7KL ==:??,-33DMMBGG d** + 3 3: ET1122FznUDE  == $}}H ]] &66H55H"// 00#11 --'']] *   . ). ) . )`  T\\%=.t++T]];T=O=OF"( r)rursrrr,rvrwrq) r0rr r>r?rrrrIr`r@r=rrrrs=2hJ  M%&Srrc URcgSSKJnJn U"U5nUR 5HYupg/nUcUR SUS35 OUR SUS35 USS U3/- nUS R U"US US 95 M[ [U5n U RS 5n U SSn U SR5(d+U RS5 U SR5(dM+U RS5n U SR5(a1U SU RS5-- n U SR5(aM1U S- n U SRU 5-n S RU RS 5Vs/sHoR5PM sn5n U $![a URs$f=fs snf)aAdd deprecated kwarg(s) to the "Other Params" section of a docstring. Parameters ---------- func : function The function whose docstring we wish to update. kwarg_mapping : dict A dict containing {old_arg: new_arg} key/value pairs, see `deprecate_parameter`. deprecated_version : str A major.minor version string specifying when old_arg was deprecated. Returns ------- new_doc : str The updated docstring. Returns the original docstring if numpydoc is not available. Nr) FunctionDoc Parameter`z` is deprecated.zDeprecated in favor of `z`.z.. deprecated:: zOther Parametersr)r(typedesc rz z ) r?numpydoc.docscraperr ImportErroritemsappendstrr!strippopjoinrstrip)r kwarg_mappingrzrrDocold_argnew_argr new_docstringr! no_headerdescrfinal_docstringlines rrrSs( ||= d C)//1 ? KK!G9$45 6 KK27)2> ? '(:';<== && 7D A 2HM    %Eab Il  "" al  "" MM! E A,     IMM!,,, A,     VOEhmmI66Oii?;P;PQU;V W;V4;V WXO O ||L!XsF$G$F=<F=c.\rSrSrSrSSjrSrSrg)channel_as_last_axisiaDecorator for automatically making channels axis last for all arrays. This decorator reorders axes for compatibility with functions that only support channels along the last axis. After the function call is complete the channels axis is restored back to its original position. Parameters ---------- channel_arg_positions : tuple of int, optional Positional arguments at the positions specified in this tuple are assumed to be multichannel arrays. The default is to assume only the first argument to the function is a multichannel array. channel_kwarg_names : tuple of str, optional A tuple containing the names of any keyword arguments corresponding to multichannel arrays. multichannel_output : bool, optional A boolean that should be True if the output of the function is not a multichannel array and False otherwise. This decorator does not currently support the general case of functions with multiple outputs where some or all are multichannel. cP[U5Ul[U5UlX0lgr8)set arg_positions kwarg_namesmultichannel_output)r:channel_arg_positionschannel_kwarg_namesrs rrIchannel_as_last_axis.__init__s& !!6723#6 rcJ^^[R"T5UU4Sj5nU$)Nc>URSS5nUcT"U0UD6$[R"U5(aU4n[U5S:a [ S5eUS:XdUS:XaT"U0UD6$T R (an/n[ U5HQupEUT R ;a+UR[R"XRSS55 M@URU5 MS [U5nOUnT RH"n[R"XUSS5X'M$ SUS'T"U0UD6nT R(a[R"USUS5nU$)N channel_axisrz1only a single channel axis is currently supported)rr) rnpisscalarrMrr enumeratermoveaxistuplerr) rQrRrnew_argsposargr(outrr:s rrU1channel_as_last_axis.__call__..fixed_funcsG!::nd;L#T,V,, {{<(( , < 1$ !TUUu$ (:T,V,,!! )$HCd000  Ca"(MN , !0 !?((!{{6<a"M ) &(F> "+F+C''kk#r<?;Jr)r]r^)r:rrUs`` rr`channel_as_last_axis.__call__s'  '  ' Rr)rrrN))rr=Trbr=rrrrs2# 7+rrc.\rSrSrSrSSS.SjrSrSrg)riaDecorate a deprecated function and warn when it is called. Adapted from . Parameters ---------- deprecated_version : str The package version when the deprecation was introduced. removed_version : str The package version in which the deprecated function will be removed. hint : str, optional A hint on how to address this deprecation, e.g., "Use `skimage.submodule.alternative_func` instead." Examples -------- >>> @deprecate_func( ... deprecated_version="1.0.0", ... removed_version="1.2.0", ... hint="Use `bar` instead." ... ) ... def foo(): ... pass Calling ``foo`` will warn with:: FutureWarning: `foo` is deprecated since version 1.0.0 and will be removed in version 1.2.0. Use `bar` instead. N)removed_versionhintc(XlX lX0lgr8)rzrr)r:rzrrs rrIdeprecate_func.__init__s"4. rc^^^^STRSTR3mTR(aTSTRS3- mTR(a"TSTRR S5S3- m[ T5m[ R"T5UUUU4Sj5nST3nURcX2lU$US-UR-UlU$) Nrz` is deprecated since version z and will be removed in version r cv>STRT5-T- n[R"T[US9 T"U0UD6$)Nrr})r;rOrrP)rQrRr,rmessager:rTs rwrapped(deprecate_func.__call__..wrappeds=T22488:EJ MM'Mj Q(( (rz**Deprecated:** z ) r0rzrrrrr]r^r?)r:rrdocrrTs`` @@rr`deprecate_func.__call__ s <&&' )     9$:N:N9OqQ QG 99 499++C013 3G$T*   )  ) ! * ?? "!O"J.@GOr)rzrrrbr=rrrrs<?C rrcn[RS:a UR$URR$)z$Return the class for a bound method.3)rversionim_class__self__ __class__)ms rrr&s&s*1::D 0D0DDrcj[R"U5S-nURS:Xa US:aSU- nOSX"S:- X"S:'[RR USUS9 [R"U5R[R5$![ a [ SUS35ef=f)a/ Attempt to safely cast values to integer format. Parameters ---------- val : scalar or iterable of scalars Number or container of numbers which are intended to be interpreted as integers, e.g., for indexing purposes, but which may not carry integer type. atol : float Absolute tolerance away from nearest integer to consider values in ``val`` functionally integers. Returns ------- val_int : NumPy scalar or ndarray of dtype `np.int64` Returns the input value(s) coerced to dtype `np.int64` assuming all were within ``atol`` of the nearest integer. Notes ----- This operation calculates ``val`` modulo 1, which returns the mantissa of all values. Then all mantissas greater than 0.5 are subtracted from one. Finally, the absolute tolerance from zero is calculated. If it is less than ``atol`` for all value(s) in ``val``, they are rounded and returned in an integer array. Or, if ``val`` was a scalar, a NumPy scalar type is returned. If any value(s) are outside the specified tolerance, an informative error is raised. Examples -------- >>> safe_as_int(7.0) 7 >>> safe_as_int([9, 4, 2.9999999999]) array([9, 4, 3]) >>> safe_as_int(53.1) Traceback (most recent call last): ... ValueError: Integer argument required but received 53.1, check inputs. >>> safe_as_int(53.01, atol=0.01) 53 rrg?)atolz'Integer argument required but received z, check inputs.) rasarrayndimtestingassert_allcloseAssertionErrorrroundastypeint64)valrmods rrr+sb **S/A C xx1} 9c'CSs^+#I  ""3"5 88C=   ))  5#o N   s BB2c`^USm[U4SjUSS55(d [S5eg)z)Check that all images have the same shaperc3V># UHnTRUR:Hv M g7fr8)shape).0imageimage0s r 'check_shape_equality..rsC uv||u{{* s&)rNz+Input images must have the same dimensions.)allr)imagesrs @rr r os2 AYF Cqr C C CFGG rc.[S54U-U4-S-$)a Construct tuple of slices to slice an array in the given dimension. Parameters ---------- sl : slice The slice for the given dimension. axis : int The axis to which `sl` is applied. All other dimensions are left "unsliced". Returns ------- sl : tuple of slices A tuple with slices matching `shape` in length. Examples -------- >>> slice_at_axis(slice(None, 3, -1), 1) (slice(None, None, None), slice(None, 3, -1), Ellipsis) N).)slice)slaxiss rr r ws!, $K>D B5 (6 11rcxURS:wa [S5eS/U-nSX2'[R"X5$)a@Reshape a 1D array to have n dimensions, all singletons but one. Parameters ---------- arr : array, shape (N,) Input array ndim : int Number of desired dimensions of reshaped array. dim : int Which dimension/axis will not be singleton-sized. Returns ------- arr_reshaped : array, shape ([1, ...], N, [1,...]) View of `arr` reshaped to the desired shape. Examples -------- >>> rng = np.random.default_rng() >>> arr = rng.random(7) >>> reshape_nd(arr, 2, 0).shape (7, 1) >>> reshape_nd(arr, 3, 1).shape (1, 7, 1) >>> reshape_nd(arr, 4, -1).shape (1, 1, 1, 7) rzarr must be a 1D arrayr)rrrreshape)arrrdim new_shapes rr r s<8 xx1}122d IIN ::c %%rc <[R"U5nSnSn[U[5(aU/nURS:Xa [ XB-5eUR U;a8[ X2SRUVs/sHn[U5PM sn54-5egs snf)a" Verify an array meets the desired ndims and array isn't empty. Parameters ---------- array : array-like Input array to be validated ndim : int or iterable of ints Allowable ndim or ndims for the array. arg_name : str, optional The name of the array in the original function. z1The parameter `%s` must be a %s-dimensional arrayz+The parameter `%s` cannot be an empty arrayrz-or-N) r asanyarray isinstanceintsizerrrr)arrayrrFmsg_incorrect_dimmsg_empty_arrayns rr r s MM% EKCO$v zzQ566 zz 6;;7M1A7M+N O O  7Ms5Bc UR[R:XaUR[R5$U(a1URR S;aUR[ 5nU$SSKJn U"U5nU$)aConvert input image to float image with the appropriate range. Parameters ---------- image : ndarray Input image. preserve_range : bool Determines if the range of the image should be kept or transformed using img_as_float. Also see https://scikit-image.org/docs/dev/user_guide/data_types.html Notes ----- * Input images with `float32` data type are not upcast. Returns ------- image : ndarray Transformed version of the input. dfr) img_as_float) dtyperfloat16rfloat32charfloat util.dtyper)rpreserve_rangers rconvert_to_floatrsg, {{bjj ||BJJ'' ;;  4 'LL'E L .U# LrcUcU[:XaS$S$US:dUS:a [S5eU[:XaUS:wa [S5eU$)aValidate and return spline interpolation's order. Parameters ---------- image_dtype : dtype Image dtype. order : int, optional The order of the spline interpolation. The order has to be in the range 0-5. See `skimage.transform.warp` for detail. Returns ------- order : int if input order is None, returns 0 if image_dtype is bool and 1 otherwise. Otherwise, image_dtype is checked and input order is validated accordingly (order > 0 is not supported for bool image dtype) rrz6Spline interpolation order has to be in the range 0-5.zInput image dtype is bool. Interpolation is not defined with bool data type. Please set order to 0 or explicitly cast input image to another data type.)boolr) image_dtypeorders r_validate_interpolation_orderr s[* }4'q.Q. qyEAITUUduz 5  Lrc.[SSSS9nX;aXnU$)z7Convert padding modes from `ndi.correlate` to `np.pad`.edge symmetricreflect)nearestrmirror)dictmodemode_translation_dicts r _to_np_moders$ YW $$* Krc^[SSSSSS9nX;a[SUS35e[X5$) zEConvert from `numpy.pad` mode name to the corresponding ndimage mode.constantrrrwrap)rr r rrzUnknown mode: 'z', or cannot translate mode. The mode should be one of 'constant', 'edge', 'symmetric', 'reflect', or 'wrap'. See the documentation of numpy.pad for more info.)rr_fix_ndimage_moders r_to_ndimage_modersS     (dV$   28 99rc.SSS.nURX5$)Nz grid-constantz grid-wrap)rr)r)r grid_modess rrr2s.{CJ >>$ %%rgGc,[U[5(a[R"SU56$[R"U5nU(dUR S:Xa [ S5e[RUR[R5$)aReturn an appropriate floating-point dtype for a given dtype. float32, float64, complex64, complex128 are preserved. float16 is promoted to float32. complex256 is demoted to complex128. Other types are cast to float64. Parameters ---------- input_dtype : np.dtype or tuple of np.dtype The input dtype. If a tuple of multiple dtypes is provided, each dtype is first converted to a supported floating point type and the final dtype is then determined by applying `np.result_type` on the sequence of supported floating point types. allow_complex : bool, optional If False, raise a ValueError on complex-valued inputs. Returns ------- float_type : dtype Floating-point dtype for the image. c38# UHn[U5v M g7fr8)_supported_float_type)rds rr(_supported_float_type..^sN+Q 5a 8 8+scz%complex valued input is not supported) rrr result_typerkindrnew_float_typerrfloat64) input_dtype allow_complexs rr!r!Fsm.+u%%~~N+NOO((;'K [--4@AA   k.. ;;rcU$)z&Returns the first argument unmodified.r=)rrQrRs rr r es Lrc[R"U5nUR[:wa2[R"US:gUS:g-5(a[ US35e[R"U[S9$)zReturn `array` as a numpy.ndarray of dtype bool. Raises ------ ValueError: An error including the given `variable_name` if `array` can not be safely cast to a boolean array. rrzo array is not of dtype boolean or contains values other than 0 and 1 so cannot be safely cast to boolean array.)r)rrrranyr)r variable_names ras_binary_ndarrayr/jsi JJu E {{d 665A:%1*- . . /"01  ::e4 ((r)gMbP?)r)F),r]rWrrOnumpyr _warningsrr__all__rr-r3r5rBrrdrrrrrrrr r r r rr rrrrrrr( complex64 complex128rr'r!r r/r=rrr5sz )   F&0.0f#T#>ll^?DMM`>(>BE A*H 22 &F 6!H"J:&&JJLRZZJJLRZZLLNr||MMO JJLRZZ <> )r