79j ddlZddlZddlZddlZddlmZddlZddlm Z m Z gdZ dZ dZ dZGd d ZGd d eZGd deZGddZdZGddeZGddZedZGddZGddZd/dZdZdZdZd0d Zd!Z d"Z!d#Z"d1d$Z#d%Z$d&Z%d'Z&d(Z'd)Z(ejRjTjVejRejXjTjVejXejZjTjVejZej\jTjVej\ej^jTjVejRd*ejXd+ej\iZ0d2d,Z1d-Z2d.Z3y)3N)contextmanager) all_warningswarn) deprecate_funcget_bound_method_classr safe_as_intcheck_shape_equalitycheck_nDr reshape_ndidentity slice_at_axisdeprecate_parameter DEPRECATEDcb|}d}t|dr|j}|dz }t|dr|S)aCount the number of inner wrappers by unpacking ``__wrapped__``. If a wrapped function wraps another wrapped function, then we refer to the wrapping of the second function as an *inner wrapper*. For example, consider this code fragment: .. code-block:: python @wrap_outer @wrap_inner def foo(): pass Here ``@wrap_inner`` applies a wrapper to ``foo``, and ``@wrap_outer`` applies a wrapper to the result. Parameters ---------- func : callable The callable of which to determine the number of inner wrappers. Returns ------- count : int The number of times `func` has been wrapped. See Also -------- count_global_wrappers r __wrapped__r)hasattrr)func unwrappedcounts U/media/conek/DATA/Code/OCR/venv/lib/python3.12/site-packages/skimage/_shared/utils.pycount_inner_wrappersrs?>I E )] +))    )] + LcVt|}t|}||z dz}t|dS)aFind stacklevel of `func` relative to its global representation. Determine automatically with which stacklevel a warning should be raised. Parameters ---------- func : Callable Tries to find the global version of `func` and counts the number of additional wrappers around `func`. Returns ------- stacklevel : int The stacklevel. Minimum of 2. r)rcount_global_wrappersmax)rinner_wrapped_countglobal_wrapped_count stacklevels r_warning_stacklevelr!Bs7"/t406%(;;a?J z1 rcd|jvr d}t||jjd^}}|jj ||}|D]}t |||}t |}|dk\sJ|S)aCount the total number of times a function as been wrapped globally. Similar to :func:`count_inner_wrappers`, this counts the number of times `func` has been wrapped. However, this function doesn't start counting from `func` but instead tries to access the "global representation" of `func`. This means that you could use this function from inside a wrapper that was applied first, and still count wrappers that were applied on top of it afterwards. E.g., `func` might be wrapped by multiple decorators that emit warnings. In that case, calling this function in the inner-most decorator will still return the total count of wrappers. Parameters ---------- func : callable The callable of which to determine the number of wrappers. Can be a function or method of a class. Returns ------- count : int The number of times `func` has been wrapped. See Also -------- count_inner_wrappers zzuCannot determine stacklevel of a function defined in another function's local namespace. Set the stacklevel manually..r) __qualname__ ValueErrorsplit __globals__getgetattrr)rmsg first_nameother global_funcpartrs rrrZs:T&&& G o**005J""&&z48K>k4= > ! -E A:: Lrc$eZdZdZddddZdZy)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. stacklevel : {None, int}, optional If None, the decorator attempts to detect the appropriate stacklevel for the deprecation warning automatically. This can fail, e.g., due to decorating a closure, in which case you can set the stacklevel manually here. The outermost decorator should have stacklevel 2, the next inner one stacklevel 3, etc. N) warning_msgr cJ||_||_||_||_||_yN)arg_name new_valuer1changed_versionr )selfr4r5r6r1r s r__init__zchange_default_value.__init__s)! "&.$rctjj}t|j j j |j j}jsdj djdjdj d|djdj djd j d _tjfd }|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.ct|dzkrej|jvrIj jn t }t j jt||i|S)Nr)r ) lenr4keysr r!warningsrr1 FutureWarning)argskwargsr arg_idxrr7s r fixed_funcz1change_default_value.__call__..fixed_funcsn4y7Q;&4== +M2OO,T2  d.. *U(( (r) inspect signature parameterslistr<indexr4defaultr1r5r6 functoolswraps)r7rrE old_valuerBrAs`` @r__call__zchange_default_value.__call__s&&t,77 z()// >t}}-55    #0t>>""243G3G2HI#}}oZ {C $ 4 45VDMM?K))-(8977;}}oW N     )  )r__name__ __module__r$__doc__r8rLrrr0r0s,DHTX%rr0ceZdZdZdZy)PatchClassReprz5Control class representations in rendered signatures.c"d|jdS)N<>)rN)clss r__repr__zPatchClassRepr.__repr__s3<<.""rN)rNrOr$rPrXrQrrrSrSs ?#rrSceZdZdZy)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. NrNrOr$rPrQrrrrsrr) metaclassc4eZdZdZeZdZdZddddddZdZy) 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 : {None, int}, optional If None, the decorator attempts to detect the appropriate stacklevel for the deprecation warning automatically. This can fail, e.g., due to decorating a closure, in which case you can set the stacklevel manually here. 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 cf||_||_||_||_||_||_||_yr3)deprecated_namer^r] start_version stop_versionr_r )r7rarbrcr]r^r_r s rr8zdeprecate_parameter.__init__s9 /    *( 0$rcB tjj} t|j j j djr3 t|j j j|j jtur tdj dtdj j}n%j j}n j}|jj j j"j$j t'j( fd}j*r@j,4t/j jij }||_|S#t$r}tj d|d}~wwxYw#t$r}tjd|d}~wwxYw)Nz not in parametersFz Expected `z` to have the value z2 to indicate its status in the rendered signature.)radeprecated_versionr6 func_namer^ct}t}t|kDr'|}j|dtfz|dzdz}j|j vr.|j}jt|j<durt|kDr|}jr+j|j vr|j}|turj j n t }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.) rr;r^rar<r r!r=rr>r%) r?r@deprecated_valuer5r deprecated_idxrnew_idxr7warning_messages rrBz0deprecate_parameter.__call__..fixed_funcSs) "I4y>)#'#7 ==,_n-%-(~1345 ##v{{}4#)$*>*>#? ==,3=F4//0e#D G(; M }}&++-!?"4==1 z12OO,T2  #m J.$5d6J6J5KL..2mm_=GH ]]., ? '(:';<== && 7D A   HM    %Eab Il  " al  " MM! E A,    IMM!,,, A,    VOEhmmI66Oii?;P;PQU;V W4 WXO O ||L!XsF ,F' F$#F$ceZdZdZy)FailedEstimationAccessErrorzError from use of failed estimation instance This error arises from attempts to use an instance of :class:`FailedEstimation`. NrZrQrrrrsrrc<eZdZdZeZdZdZdZdZ dZ dZ dZ y ) FailedEstimationaClass to indicate a failed transform estimation. The ``from_estimate`` class method of each transform type may return an instance of this class to indicate some failure in the estimation process. Parameters ---------- message : str Message indicating reason for failed estimation. Attributes ---------- message : str Message above. Raises ------ FailedEstimationAccessError Exception raised for missing attributes or if the instance is used as a callable. zYou can check for a failed estimation by truth testing the returned object. For failed estimations, `bool(estimation_result)` will be `False`. E.g. if not estimation_result: raise RuntimeError(f'Failed estimation: {estimation_result}')c||_yr3message)r7rs rr8zFailedEstimation.__init__s  rcy)NFrQr7s r__bool__zFailedEstimation.__bool__srcLt|jd|jdS)N())r{rNrrs rrXzFailedEstimation.__repr__s%t*%%&a '7q99rc|jSr3rrs r__str__zFailedEstimation.__str__s ||rct|jd|jd|j}|j |)Nz is not callable.  Hint: r{rNrhint error_cls)r7r?r@r*s rrLzFailedEstimation.__call__sGDz""##5dll^DYYK ! nnS!!rct|jd|d|jd|j}|j |)Nz has no attribute z. rr)r7rzr*s r __getattr__zFailedEstimation.__getattr__ sMDz""##5dXR ~NYYK ! nnS!!rN) rNrOr$rPrrrr8rrXrrLrrQrrrrs7,,I P :""rrc#Ktj5tjdtddddddy#1swYyxYww)zmFilter warnings about the deprecated `estimate` method. Use either as decorator or context manager. ignorez`estimate` is deprecatedskimage)actionrirmoduleN)r=catch_warningsfilterwarningsr>rQrr#_ignore_deprecated_estimate_warningrsG  "".  sA"A AA Ac$eZdZdZ ddZdZy)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. cRt||_t||_||_yr3)set arg_positions kwarg_namesmultichannel_output)r7channel_arg_positionschannel_kwarg_namesrs rr8zchannel_as_last_axis.__init__;s( !!6723#6 rcFtjfd}|S)Nc~|jdd}||i|Stj|r|f}t|dkDr t d|dk(s|dk(r|i|S j rjg}t |D]N\}}| j vr*|jtj||dd>|j|Pt|}n|} jD]"}tj|||dd||<$d|d<|i|} jrtj|d|d}|S)N channel_axisrz1only a single channel axis is currently supported)rr) r(npisscalarr;r%r enumeratermoveaxistuplerr) r?r@rnew_argsposargrzoutrr7s rrBz1channel_as_last_axis.__call__..fixed_funcFsX!::nd;L#T,V,, {{<( , < 1$ !TUUu$ (:T,V,,!! )$-HCd000  Ca"(MN , - !?(( N!{{6$<a"Mt  N &(F> "+F+C''kk#r<?;Jr)rIrJ)r7rrBs`` rrLzchannel_as_last_axis.__call__Es'  '  ' RrN))rrQTrMrQrrrr#s2# 7+rrc&eZdZdZdddddZdZy)raDecorate 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." stacklevel : {None, int}, optional If None, the decorator attempts to detect the appropriate stacklevel for the deprecation warning automatically. This can fail, e.g., due to decorating a closure, in which case you can set the stacklevel manually here. The outermost decorator should have stacklevel 2, the next inner one stacklevel 3, etc. 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_versionrr c<||_||_||_||_yr3rerrr )r7rerrr s rr8zdeprecate_func.__init__s"#5. $rc~djdjjrdjdz jr"djj ddz t j fd}d}|j ||_|S|dz|jz|_|S) Nrxz` is deprecated since version z and will be removed in version r# cj jn t}tjt||i|S)Nrh)r r!r=rr>)r?r@r rrr7s rwrappedz(deprecate_func.__call__..wrappedsG??.(.  MM'Mj Q(( (rz**Deprecated:** z )rNrerrrrIrJrP)r7rrdocrs`` @rrLzdeprecate_func.__call__s 4F""((-a0JJ >!J<'Q R      rcd}t|dj}|j|_tj||_t ||j|_|S)zDeprecate inherited ``estimate`` instance method. This needs a class decorator so we can correctly specify the class of the `from_estimate` class method in the deprecation message. c*|j|i|duSr3) _estimate)r7r?r@s restimatez/_deprecate_inherited_estimate..estimatest~~t.v.$66rr) r)rrPrCrD __signature__rrNr)rWrinherited_meths r_deprecate_inherited_estimatersS7S*-99N%--H$..~>H&x>CL Jrct|dfd}jjdd}jj ||j |_t j|_t||_ |S)a3Fix docstring for inherited ``from_estimate`` class method. Even for classes that inherit the `from_estimate` method, and do not override it, we nevertheless need to change the *docstring* of the `from_estimate` method to point the user to the current (inheriting) class, rather than the class in which the method is defined (the inherited class). This needs a class decorator so we can modify the docstring of the new class method. CPython currently does not allow us to modify class method docstrings by updating ``__doc__``. from_estimatec|i|Sr3rQ)rWr?r@inherited_cmeths rrz6_update_from_estimate_docstring..from_estimates///rr#) r)r$r&rPreplacerNrCrDr classmethodr)rWrinherited_class_namers @r_update_from_estimate_docstringrs}c?3O0+77==cB2F+33;;cllM#*"3"3O"DM#M2C Jrcltjdkr |jS|jjS)z$Return the class for a bound method.3)sysversionim_class__self__ __class__)ms rrrs&s*1::D 0D0DDrc:tj|dz}|jdk(r |dkDrd|z }nd||dkDz ||dkD<tj|d|st d|dtj |j tjS)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.)rasarrayndimallcloser%roundastypeint64)valrmods rr r sb **S/A C xx1} 9c'CSs^+C#I ;;sAD )B3%WXX 88C=   ))rcT|dtfd|ddDs tdy)z)Check that all images have the same shaperc3PK|]}j|jk(ywr3)shape).0imageimage0s r z'check_shape_equality..AsCuv||u{{*Cs#&rNz+Input images must have the same dimensions.)allr%)imagesrs @rr r >s/ AYF Cqr C CFGG rc.tdf|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 rrrFs!, $K>D B5 (6 11rcx|jdk7r tddg|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)rr%rreshape)arrrdim new_shapes rr r _s@8 xx1}122d IIcN ::c9 %%rc (tj|}d}d}t|tr|g}|jdk(rt ||z|j |vr6t ||dj|Dcgc] }t|c}fzycc}w)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-N) r asanyarray isinstanceintsizer%rrr)arrayrr4msg_incorrect_dimmsg_empty_arrayns rr r s MM% EKCO$v zzQH566 zz 6;;7M1A7M+N O O  7Ms.Bc|jtjk(r|jtjS|r/|jj dvr|jt }|Sddlm}||}|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_floatrsg, {{bjj ||BJJ'' ;;  4 'LL'E L .U# Lrc| |tk(rdSdS|dks|dkDr td|tk(r|dk7r td|S)aValidate and return spline interpolation's order. Parameters ---------- image_dtype : dtype Image dtype. order : {None, int}, optional The order of the spline interpolation. The order has to be in the range 0-5. If ``None`` assume order 0 for Boolean images, otherwise 1. 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_orderrs[, }4'q.Q. qyEAIQRRduz 5  Lrc4tddd}||vr||}|S)z7Convert padding modes from `ndi.correlate` to `np.pad`.edge symmetricreflect)nearestr!mirror)dictmodemode_translation_dicts r _to_np_moder(s) YW $$$T* Krcdtddddd}||vrtd|dt||S) zEConvert from `numpy.pad` mode name to the corresponding ndimage mode.constantr"r!r#wrap)r*rr r!r+zUnknown 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.)r$r%_fix_ndimage_moder%s r_to_ndimage_moder-sX     ((dV$   248 99rc0ddd}|j||S)Nz grid-constantz grid-wrap)r*r+)r()r& grid_modess rr,r,s.{CJ >>$ %%rgGct|trtjd|DStj|}|s|j dk(r t dtj|jtjS)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. c32K|]}t|ywr3)_supported_float_type)rds rrz(_supported_float_type...sNQ 5a 8Nscz%complex valued input is not supported) rrr result_typerkindr%new_float_typer(rfloat64) input_dtype allow_complexs rr4r4sj.+u%~~N+NOO((;'K [--4@AA   k.. ;;rc|S)z&Returns the first argument unmodified.rQ)rr?r@s rr r 5s Lrctj|}|jtk7r,tj|dk7|dk7zrt |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)rrrranyr%)r  variable_names ras_binary_ndarrayrA:sf JJu E {{d 665A:%1*- . /"01  ::e4 ((rr3)gMbP?)r)F)4rIrCrr= contextlibrnumpyr _warningsrr__all__rr!rr0r{rSrrrrAttributeErrorrrrrrrrrrr r rr r rrr(r-r,rrrr: complex64 complex128rr9r4r rArQrrrIs %)  $N0.b::z#T#>rrj?D.9"9"x  MM`HHV &:E =*@ 22 &F 6!H#L:&&BJJLRZZBJJLRZZBLLNr||BMMO BJJLRZZ <> )r