0-PhsddlZddlZddlZddlZddlZddlmZmZgdZ dZ dZ dZ Gdd Z Gd d e ZGd d eZGddeZGddZdZGddZGdde ZdZd+dZdZdZdZd,dZd Zd!Zd"Zd#Zd$Z ej!j"j#ej!ej$j"j#ej$ej%j"j#ej%ej&j"j#ej&ej'j"j#ej!d%ej$d&ej&iZ(d-d(Z)d)Z*d*Z+dS).N) all_warningswarn) deprecate_funcget_bound_method_classr safe_as_intcheck_shape_equalitycheck_nDr reshape_ndidentity slice_at_axisdeprecate_parameter DEPRECATEDcf|}d}t|dr|j}|dz }t|d|S)z+Count the number of wrappers around `func`.r __wrapped__r)hasattrr)func unwrappedcounts U/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/skimage/_shared/utils.py_count_wrappersrsJI E )] + +)    )] + + Lcrt|}tj|j} |jdD]}t||} t|}n.#t$r!}td|jd|d|d}~wwxYw||z dz}t|dS)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 <%++C00 0 0D!&$//KK 0 /{;;  <!2 < < < < <   & 59J z1  s-A33 B=BBcd|j|j|}t|}|S)z"Return function call stack length.) __globals__r__name__r)r_funclengths r_get_stack_lengthr3Gs.    5 5E U # #F MrceZdZdZiZdZdS)_DecoratorBaseClassaUsed 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`. c`|j|jt|}|SN) _stack_lengthrr0r3)selfrr2s rget_stack_lengthz$_DecoratorBaseClass.get_stack_length\s*#'' 7H7N7NOO rN)r0rr __doc__r8r:rrr5r5Ns4  Mrr5c$eZdZdZdddZdZdS)change_default_valueaDecorator 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_msgc>||_||_||_||_dSr7)arg_name new_valuer?changed_version)r9rArBrCr?s r__init__zchange_default_value.__init__rs&  "&.rctjj}t|j|jj}tj Kdjdj dj djd|dj djdj d jd _ tj fd }|S) 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.cdzz }t|dzkr<j|vr!t jjt||i|S)Nr)r,)r:lenrAkeyswarningsrr? FutureWarning)argskwargsr,arg_idxrr9 stack_ranks r fixed_funcz1change_default_value.__call__..fixed_funcsxT224888:EJ4yy7Q;&&4= +M+M d. *UUUU4((( (r)inspect signature parameterslistrHindexrAdefaultrr?rBrC functoolswraps)r9rrR old_valuerOrMrNs`` @@r__call__zchange_default_value.__call__xsa&t,,7 z(())// >>t}-5 $T**   #NNN>NN373GNN#}NN8ANN!% 4NN=AMNN*. NN 8<} NNN      ) ) ) ) ) ) )   )rr0rr r;rDrYr<rrr>r>asM MQ///// rr>ceZdZdZdZdS)PatchClassReprz5Control class representations in rendered signatures.cd|jdS)N<>)r0)clss r__repr__zPatchClassRepr.__repr__s"3<""""rN)r0rr r;rar<rrr\r\s)??#####rr\ceZdZdZdS)raSignal 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. N)r0rr r;r<rrrrsrr) metaclassc6eZdZdZeZdZdZddddddZdZdS) raDeprecate 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,ch||_||_||_||_||_||_||_dSr7)deprecated_namerfre start_version stop_versionrgr,)r9rirjrkrerfrgr,s rrDzdeprecate_parameter.__init__s= /    *( 0$rctjj}t|jjr:t|jnd|jjtur tdjdtdj j }njj }nj }|jjjjjt%jfd}jr0j)t-jjij}||_|S)NFz Expected `z` to have the value z2 to indicate its status in the rendered signature.)rideprecated_versionrC func_namerfct}t}t|kr0|}j!|dtfz|dzdz}j|vr#|j}jt|j<durt|kr|}jr(j|vr |j}|tursjjnt }tj t||tur tdjdjdj ||j<|i|S)NrFcategoryr,zBoth deprecated parameter `z` and new parameter `z<` are used. Use only the latter to avoid conflicting values.) rrGrfrirHr,r-rIrrJ ValueError) rKrLdeprecated_valuerBr,deprecated_idxrnew_idxr9warning_messages rrOz0deprecate_parameter.__call__..fixed_funcs) "I4yy>))#'#7 =,_n_-%-(~13345 #v{{}}44#)$*>#? =,3=F4/0e##D G(;(; M } 2&++--!?!?"4=1 z112OO,T22  #m J..$Hd6JHH.2mHHH ].,z-_docstring_add_deprecated..s W W W4 W W Wr) r;numpydoc.docscraper}r~ ImportErroritemsappendstrr!strippopjoin)r kwarg_mappingrmr}r~Docold_argnew_argr new_docstringr! no_headerdescrfinal_docstrings rrzrzSsK( |t========= | +d  C)//11    ? KK5G555 6 6 6 6 KK>7>>> ? ? ? <(:<<== && I7D A A A    HHM    % %Eabb Il  "" al  "" MM!  E A,    - IMM!,,,, A,    - VOEhmmI666Oii W W?;P;PQU;V;V W W WXXO s ((c&eZdZdZ ddZdZdS) channel_as_last_axisa%Decorator 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. rr<Tcdt||_t||_||_dSr7)set arg_positions kwarg_namesmultichannel_output)r9channel_arg_positionschannel_kwarg_namesrs rrDzchannel_as_last_axis.__init__s4 !!677233#6   rcJtjfd}|S)Nc|dd}||i|Stj|r|f}t|dkrt d|dks|dkr|i|S jrug}t |D]S\}}| jvr0|tj||dd>||Tt|}n|} j D]'}tj|||dd||<(d|d<|i|} j rtj|d|d}|S)N channel_axisrz1only a single channel axis is currently supported)rr) rnpisscalarrGrrr enumeratermoveaxistuplerr) rKrLrnew_argsposargr(outrr9s rrOz1channel_as_last_axis.__call__..fixed_funcs!::nd;;L#tT,V,,, {<(( / , <  1$$ !TUUUu$$ (:(:tT,V,,,!  )$--HCd000  Ca"(M(MNNNN ,,,, ??( N N!{6$<a"MMt &(F> "$+F++C' <k#r<?;;Jr)rVrW)r9rrOs`` rrYzchannel_as_last_axis.__call__s@   ' ' ' ' '   ' RrN)rr<TrZr<rrrrsL2# 7777+++++rrc&eZdZdZddddZdZdS)ravDecorate 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_versionhintc0||_||_||_dSr7)rmrr)r9rmrrs rrDzdeprecate_func.__init__s"4. rcZdjdjjrdjdz jr!djddz t t jfd}d}|j||_n|dz|jz|_|S) Nrz` is deprecated since version z and will be removed in version r cdzz }tjt||i|S)Nrrp)r:rIrrJ)rKrLr,rmessager9rNs rwrappedz(deprecate_func.__call__..wrappedsLT224888:EJ M'Mj Q Q Q Q4((( (rz**Deprecated:** z ) r0rmrrrrrVrWr;)r9rrdocrrNs`` @@rrYzdeprecate_func.__call__ s )  ) )& ) )    R Q$:NQQQ QG 9 4 349++C00333 3G$T**    ) ) ) ) ) ) )   ) +** ? "!GOO!J.@GOrrZr<rrrrsN<?C rrcHtjdkr|jn |jjS)z$Return the class for a bound method.3)rversionim_class__self__ __class__)ms rrr&ss**1:: 0DDrMbP?cvtj|dz}|jdkr |dkrd|z }nd||dkz ||dk< tj|d|n!#t $rt d|dwxYwtj|tj S)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_allcloseAssertionErrorrrroundastypeint64)valrmods rrr+sb *S//A C x1}} 99c'CSs^+C#I  ""3"5555     N# N N N    8C==   ) ))s "A))Bc||dtfd|ddDstddS)z)Check that all images have the same shaperc38K|]}j|jkVdSr7)shape)rimageimage0s r z'check_shape_equality..rs,CCuv|u{*CCCCCCrrNz+Input images must have the same dimensions.)allrr)imagesrs @rr r osN AYF CCCCqrr CCC C CHFGGG Frc6tdf|z|fzdzS)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#, $KK>D B5 (6 11rcv|jdkrtddg|z}d||<tj||S)aReshape 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)rrrrreshape)arrrdim new_shapes rr r sD8 x1}}1222d IIcN :c9 % %%rrctj|}d}d}t|tr|g}|jdkrt ||z|j|vr1t ||dd|DfzdS)aJ 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-c,g|]}t|Sr<)r)rns rrzcheck_nD..s7M7M7M1A7M7M7MrN)r asanyarray isinstanceintsizerrrr)arrayrrAmsg_incorrect_dimmsg_empty_arrays rr r s M% EKCO$v zQH5666 z 6;;7M7M7M7M7M+N+N O O   rc|jtjkr|tjS|r)|jjdvr|t }nddlm}||}|S)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_floatrsy, {bj  ||BJ'''$ ; 4 ' 'LL''E------ U## Lrc||tkrdndS|dks|dkrtd|tkr|dkrtd|S)a3Validate 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) Nrrz6Spline 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.)boolrr) image_dtypeorders r_validate_interpolation_orderrsn* }4''qqQ. qyyEAIITUUUduzz 5   LrcBtddd}||vr||}|S)z7Convert padding modes from `ndi.correlate` to `np.pad`.edge symmetricreflect)nearestrmirror)dictmodemode_translation_dicts r _to_np_moders2 YWWW $$$$T* Krctddddd}||vrtd|dt||S) zEConvert from `numpy.pad` mode name to the corresponding ndimage mode.constantrrrwrap)rrrrrzUnknown 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.)rrr_fix_ndimage_moders r_to_ndimage_moder sr     ((( d      248 9 99rc8ddd}|||S)Nz grid-constantz grid-wrap)rr)r)r grid_modess rrr2s%.{CCJ >>$ % %%rgGFct|trtjd|DStj|}|s|jdkrt dt|j tj S)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. c34K|]}t|VdSr7)_supported_float_type)rds rrz(_supported_float_type..^s+NNQ 5a 8 8NNNNNNrcz%complex valued input is not supported) rrr result_typerkindrrnew_float_typerrfloat64) input_dtype allow_complexs rrrFs.+u%%P~NN+NNNOO(;''K B[-44@AAA   k. ; ;;rc|S)z&Returns the first argument unmodified.r<)rrKrLs rr r es Lrctj|}|jtkr1tj|dk|dkzrt |dtj|tS)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)rrrranyrr)r variable_names ras_binary_ndarrayrjsz Ju  E {d 65A:%1*- . .  111  :e4 ( ( ((r)r)r)F),rVrPrrInumpyr _warningsrr__all__rr-r3r5r>rr\rrrzrrrrr r r r rrrr rrrrr complex64 complex128rrrr rr<rrr#sP ))))))))       F&00000.000f#####T###>llllllll^???DMMMMMMMM`>>>>>(>>>BEEE A*A*A*A*H   2222 & & &F    6!!!H"""J:::&&&&BJLLRZBJLLRZBLNNr|BMOO BJLLRZ <<<<> )))))r