U ?hc@sddlZddlZddlZddlZddlZddlmZmZdddddd d d d d g Z ddZ ddZ ddZ GdddZ Gddde ZGddde ZddZGddde ZGdddZGd dde Zd!dZd;d#dZd$dZd%d Zd&d ZdN) all_warningswarndeprecate_funcget_bound_method_classr safe_as_intcheck_shape_equalitycheck_nDr reshape_ndidentity slice_at_axiscCst|rdt|jSdSdS)z'Return function rank in the call stack.rrN) _is_wrapped_get_stack_rank __wrapped__funcrG/var/www/html/venv/lib/python3.8/site-packages/skimage/_shared/utils.pyrsrcCs dt|kS)Nr)dirrrrrr sr cCst|j|j|S)z"Return function call stack length.)r __globals__get__name__rrrr_get_stack_lengthsrc@seZdZdZiZddZdS)_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`. cCs|j|jt|SN) _stack_lengthrrr)selfrrrrget_stack_length.s z$_DecoratorBaseClass.get_stack_lengthN)r __module__ __qualname____doc__rrrrrrr s rc@s&eZdZdZddddZddZdS)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_msgcCs||_||_||_||_dSr)arg_name new_valuer"changed_version)rr#r$r%r"rrr__init__Dszchange_default_value.__init__cstj}t|j|jj}tj dkrdjdj dj djd|dj djdj d jd _ t fd d }|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.csLd}t|dkrBj|krBtjjt|d||SNr stacklevel)rlenr#keyswarningsrr" FutureWarningargskwargsr)arg_idxrr stack_rankrr fixed_func[s  z1change_default_value.__call__..fixed_func)inspect signature parameterslistr+indexr#defaultrr"r$r% functoolswraps)rrr7 old_valuer4rr1r__call__Ks   Jzchange_default_value.__call__rrrr r&r>rrrrr!3s r!c@s&eZdZdZddddZddZdS) remove_argafDecorator to remove an argument from function's signature. Parameters ---------- arg_name: str The name of the argument to be removed. changed_version : str The package version in which the warning will be replaced by an error. help_msg: str Optional message appended to the generic warning message. N)help_msgcCs||_||_||_dSr)r#rAr%)rr#r%rArrrr&vszremove_arg.__init__cstj}t|jjdjdjdjdj dk r^dj 7t t fdd}|S)Nz7 argument is deprecated and will be removed in version z/. To avoid this warning, please do not use the z argument. Please see z documentation for more details. csFd}t|ks,j|kr.fixed_func) r5r6r7r8r+r9r#r%rrArr;r<)rrr7r4rrCrr>{s " zremove_arg.__call__r?rrrrr@gsr@cCs|jdkrdSzddlm}m}Wntk r<|jYSX||}|D]8\}}d|ddd|g}|d||d |d qNt|} | d } | d d} | d s| dq| d} | d r| d | d7} q| d7} | d | } d dd| d D} | S)a2Add 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 as used by `deprecate_kwarg`. 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 ParameterzDeprecated in favor of `z`.z.. deprecated:: zOther ParametersZ DEPRECATED)nametypedesc rz z cSsg|] }|qSr)rstrip).0linerrr sz-_docstring_add_deprecated..) r Znumpydoc.docscraperDrE ImportErroritemsappendstrsplitstrippopjoin)r kwarg_mappingdeprecated_versionrDrEDocold_argnew_argrIZ new_docstringrSZ no_headerdescrZfinal_docstringrrr_docstring_add_deprecateds@         r]c@s"eZdZdZdddZddZdS)deprecate_kwarga9Decorator ensuring backward compatibility when argument names are modified in a function definition. Parameters ---------- kwarg_mapping: dict Mapping between the function's old argument names and the new ones. deprecated_version : str The package version in which the argument was first deprecated. warning_msg: str Optional warning message. If None, a generic warning message is used. removed_version : str The package version in which the deprecated argument will be removed. NcCsR||_|dkrBd|_|dk r2|jd|d7_|jd7_n||_||_dS)Nz=`{old_arg}` is a deprecated argument name for `{func_name}`. zIt will be removed in version z. zPlease use `{new_arg}` instead.)rWr"rX)rrWrXr"removed_versionrrrr&szdeprecate_kwarg.__init__csFttfdd}jdk rBtjj}||_|S)Ncsfd}jD]>\}}||krtjjj|j|dt|d| |||<q||S)Nr)rZ func_namer[r() rrWrPr,rr"formatrr-rU)r/r0r)rZr[rrr3rrr4s z,deprecate_kwarg.__call__..fixed_func)rr;r<r r]rWrX)rrr4Znewdocrrbrr>s zdeprecate_kwarg.__call__)NNr?rrrrr^s  r^c@s"eZdZdZd ddZddZd S) 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. rrTcCst||_t||_||_dSr)set arg_positions kwarg_namesmultichannel_output)rZchannel_arg_positionsZchannel_kwarg_namesrhrrrr&.s  zchannel_as_last_axis.__init__cstfdd}|S)Ncs |dd}|dkr||St|r.|f}t|dkrBtd|dksR|dkr\||Sjrg}t|D]6\}}|jkr|t||ddqn||qnt |}n|}j D]}t|||dd||<qd|d<||}j rt|d|d}|S)N channel_axisrz1only a single channel axis is currently supported)rjr) rnpZisscalarr* ValueErrorrf enumeraterQZmoveaxistuplergrh)r/r0rinew_argsposargrGoutrrrrr46s4          z1channel_as_last_axis.__call__..fixed_func)r;r<)rrr4rrsrr>4s+zchannel_as_last_axis.__call__N)rdrTr?rrrrrcs  rcc@s(eZdZdZdddddZddZdS)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)r_hintcCs||_||_||_dSr)rXr_rt)rrXr_rtrrrr&szdeprecate_func.__init__csdjdjjr,djd7jrJdjdd7ttfdd}d}|jdkr||_n|d |j|_|S) N`z` is deprecated since version z and will be removed in version .rBcs,d}tjt|d||S)Nr)categoryr))rr,rr-r.rmessagerr3rrwrappedsz(deprecate_func.__call__..wrappedz**Deprecated:** z ) rrXr_rtrKrr;r<r )rrrzdocrrxrr>s  zdeprecate_func.__call__r?rrrrrescCstjdkr|jS|jjS)z*Return the class for a bound method. 3)sysversionZim_class__self__ __class__)mrrrrsMbP?cCst|d}|jdkr*|dkrBd|}nd||dk||dk<ztjj|d|dWn$tk r|td|dYnXt|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.) rkasarrayndimZtestingZassert_allcloseAssertionErrorrlroundastypeZint64)valrmodrrrrs1  cs2|dtfdd|ddDs.tddS)z)Check that all images have the same shaperc3s|]}j|jkVqdSr)shape)rLimageZimage0rr sz'check_shape_equality..rNz+Input images must have the same dimensions.)allrl)ZimagesrrrrscCstdf||fdS)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)slZaxisrrrr scCs0|jdkrtddg|}d||<t||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 arrayrj)rrlrkZreshape)ZarrrdimZ new_shaperrrr s   rcCsft|}d}d}t|tr"|g}|jdkr8t|||j|krbt||ddd|DfdS)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-cSsg|] }t|qSr)rR)rLnrrrrNOszcheck_nD..N)rkZ asanyarray isinstanceintsizerlrrV)arrayrr#Zmsg_incorrect_dimZmsg_empty_arrayrrrr 8s     cCsL|jtjkr|tjS|r4|jjdkrH|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. Zdf) img_as_float) dtyperkfloat16rfloat32charfloatZ util.dtyper)rZpreserve_rangerrrrconvert_to_floatSs     rcCsL|dkr|tkrdSdS|dks(|dkr0td|tkrH|dkrHtd|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.)boolrl)Z image_dtypeorderrrr_validate_interpolation_ordervsrcCs"tdddd}||kr||}|S)z7Convert padding modes from `ndi.correlate` to `np.pad`.edge symmetricreflect)nearestrmirror)dictmodeZmode_translation_dictrrr _to_np_modes rcCs6tdddddd}||kr*td|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.)rrl_fix_ndimage_moderrrr_to_ndimage_modes rcCsddd}|||S)Nz grid-constantz grid-wrap)rr)r)rZ grid_modesrrrrs rgGFcCsNt|trtjdd|DSt|}|s>|jdkr>tdt|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. css|]}t|VqdSr)_supported_float_type)rLdrrrrsz(_supported_float_type..cz%complex valued input is not supported) rrnrkZ result_typerkindrlnew_float_typerrfloat64)Z input_dtypeZ allow_complexrrrrs   rcOs|S)z&Returns the first argument unmodified.r)rr/r0rrrr scCsFt|}|jtkr8t|dk|dk@r8t|dtj|tdS)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)rkrrranyrl)rZ variable_namerrras_binary_ndarrays  r)r)r)F)*r;r5r}r,numpyrk _warningsrr__all__rr rrr!r@r]r^rcrrrrr r r rrrrrrrrrZ complex64Z complex128rrrr rrrrrsj4/B?NE C# #%