o :ήcJG@s8ddlZddlmZgdZejejejejej ej e ej ej ejejf ZddeDZedejdejdedejdejdejdejdiZeeeeZd&d d Zd d Z d'ddZ!d(ddZ"d)ddZ#d)ddZ$e#j%durwe#j%de$_%d&ddZ&d&ddZ'd&ddZ(d&ddZ)d&d d!Z*d&d"d#Z+d&d$d%Z,dS)*N)warn)img_as_float32img_as_float64 img_as_float img_as_int img_as_uint img_as_ubyte img_as_bool dtype_limitscCs&i|]}|t|jt|jfqS)npiinfominmax).0tr r 9/tmp/pip-target-vg8gfxp4/lib/python/skimage/util/dtype.py sr)FT)FcCs t|jj\}}|r d}||fS)aReturn intensity limits, i.e. (min, max) tuple, of the image's dtype. Parameters ---------- image : ndarray Input image. clip_negative : bool, optional If True, clip the negative range (i.e. return 0 for min intensity) even if the image dtype allows negative values. Returns ------- imin, imax : tuple Lower and upper intensity limits. r) dtype_rangedtypetype)image clip_negativeiminimaxr r rr &sr cstfdd|DS)aReturn first of `dtypes` with itemsize greater than `itemsize` Parameters ---------- itemsize: int The data type object element size. Other Parameters ---------------- *dtypes: Any Object accepted by `np.dtype` to be converted to a data type object Returns ------- dtype: data type object First of `dtypes` with itemsize greater than `itemsize`. c3s$|] }t|jkr|VqdS)N)r ritemsize)rdtrr r Ps"z"_dtype_itemsize..)next)rdtypesr rr_dtype_itemsize<sr#rcs0tfdd|fdD}tt|S)acReturn dtype of `kind` that can store a `bits` wide unsigned int Parameters: kind: str Data type kind. bits: int Desired number of bits. itemsize: int The data type object element size. Returns ------- dtype: data type object Data type of `kind` that can store a `bits` wide unsigned int c3s4|]}|dks|dkrdkr|VqdS)uNr )ribitskindr rr es  z_dtype_bits..)r$)r!r rstr)r)r(rsr r'r _dtype_bitsSsr.Tc CsL|jj}||krR|d|krRtt|dd}||kr%d|}nd|}tt|dd}td|jd|d|d|dd |t||S||kr^|r\| S|S||kr|rt |j t||}tj |d||||jd d |S|d||}|S||d kr|rt |j t||}tj |d|d d|d ||jd|S|jt|||jjdd}|d|d d|d 9}|S||d |}|rt |j t||}tj |d|d d|d ||jd|d||}|S|jt|||jjdd}|d|d d|d 9}|d||}|S)aIScale an array of unsigned/positive integers from `n` to `m` bits. Numbers can be represented exactly only if `m` is a multiple of `n`. Parameters ---------- a : ndarray Input image array. n : int Number of bits currently used to encode the values in `a`. m : int Desired number of bits to encode the values in `out`. copy : bool, optional If True, allocates and returns new array. Otherwise, modifies `a` in place. Returns ------- out : array Output image array. Has the same kind as `a`. r*intuintz Downcasting  to z# without scaling because max value z fits in  stacklevelunsafeoutrcastingrr)r7rFcopy)rr)rr/r ceilrastyper.r:emptyshape floor_dividemultiplyr) anmr:r)mnewrbor r r_scaleksX   ((rGcCst|}|j}|tjurtd}nt|}|j}|j}|j}|j} |j} |j} t|t|r;|r9| }|S|t vrC|t vsNt d|d|d|dvr^t |j } t |j} | dvrnt |j }t |j}| dkr~||t|ddkS|dkr||}| d kr||t|d9}|S|d kr,| d kr||St |d kst|d krt d t| |tjtj}|s| d krtj|||d}ntj|||d|d}|d8}tj||dtj||||dn7| d kr tj||d|d}tj|d||dntj|||d d|d}tj||dtj||||d||S| d krxt| |tjtj}|d krJtj|d | |d}n(|dkrbtj|d | |d}tj|d |dntj|d|d}|d| | 9}t||S|d kr| dkrt|d| d| d}||St|d| d| S| d krt|d| dd| }t|j|}tj|d||jdd|S| | krt|d| dd| dS|td| d}|| 8}t|d| d| dd}||7}||S)a Convert an image to the requested data-type. Warnings are issued in case of precision loss, or when negative values are clipped during conversion to unsigned integer types (sign loss). Floating point values are expected to be normalized and will be clipped to the range [0.0, 1.0] or [-1.0, 1.0] when converting to unsigned or signed integers respectively. Numbers are not shifted to the negative side when converting from unsigned to signed integer types. Negative values will be clipped when converting to unsigned integers. Parameters ---------- image : ndarray Input image. dtype : dtype Target data-type. force_copy : bool, optional Force a copy of the data, irrespective of its current dtype. uniform : bool, optional Uniformly quantize the floating point range to the integer range. By default (uniform=False) floating point values are scaled and rounded to the nearest integers, which minimizes back and forth conversion errors. .. versionchanged:: 0.15 ``_convert`` no longer warns about possible precision or sign information loss. See discussions on these warnings at: https://github.com/scikit-image/scikit-image/issues/2602 https://github.com/scikit-image/scikit-image/issues/543#issuecomment-208202228 https://github.com/scikit-image/scikit-image/pull/3575 References ---------- .. [1] DirectX data conversion rules. https://msdn.microsoft.com/en-us/library/windows/desktop/dd607323%28v=vs.85%29.aspx .. [2] Data Conversions. In "OpenGL ES 2.0 Specification v2.0.25", pp 7-8. Khronos Group, 2010. .. [3] Proper treatment of pixels as integers. A.W. Paeth. In "Graphics Gems I", pp 249-256. Morgan Kaufmann, 1990. .. [4] Dirty Pixels. J. Blinn. In "Jim Blinn's corner: Dirty Pixels", pp 47-57. Morgan Kaufmann, 1998. float64zCannot convert from r1.uirErr*fgg?z.Images of type float must be between -1 and 1.r%)rg?)r7rg@r&r$r5r6Fr9)r asarrayrfloatingrr)r issubdtype obj2sctyper:_supported_types ValueErrorr rrrr<r#float32rHr@rintclipfloormaximumaddrGviewr=r>r.)rr force_copyuniform dtypeobj_in dtypeobj_outdtype_in dtype_outkind_inkind_out itemsize_in itemsize_outimin_inimax_inimin_outimax_outresultcomputation_type image_outr r r_converts 0                            rjcCstdtddt||||dS)NzThe use of this function is discouraged as its behavior may change dramatically in scikit-image 1.0. This function will be removed in scikit-image 1.0.r*r3rrrYrZ)r FutureWarningrjrkr r rconvertps rmz Warns ----- FutureWarning: .. versionadded:: 0.17 The use of this function is discouraged as its behavior may change dramatically in scikit-image 1.0. This function will be removed in scikit-image 1.0. cCt|tj|S)ajConvert an image to single-precision (32-bit) floating point format. Parameters ---------- image : ndarray Input image. force_copy : bool, optional Force a copy of the data, irrespective of its current dtype. Returns ------- out : ndarray of float32 Output image. Notes ----- The range of a floating point image is [0.0, 1.0] or [-1.0, 1.0] when converting from unsigned or signed datatypes, respectively. If the input image has a float type, intensity values are not modified and can be outside the ranges [0.0, 1.0] or [-1.0, 1.0]. )rjr rRrrYr r rrrcCrn)ajConvert an image to double-precision (64-bit) floating point format. Parameters ---------- image : ndarray Input image. force_copy : bool, optional Force a copy of the data, irrespective of its current dtype. Returns ------- out : ndarray of float64 Output image. Notes ----- The range of a floating point image is [0.0, 1.0] or [-1.0, 1.0] when converting from unsigned or signed datatypes, respectively. If the input image has a float type, intensity values are not modified and can be outside the ranges [0.0, 1.0] or [-1.0, 1.0]. )rjr rHror r rrrprcCrn)aConvert an image to floating point format. This function is similar to `img_as_float64`, but will not convert lower-precision floating point arrays to `float64`. Parameters ---------- image : ndarray Input image. force_copy : bool, optional Force a copy of the data, irrespective of its current dtype. Returns ------- out : ndarray of float Output image. Notes ----- The range of a floating point image is [0.0, 1.0] or [-1.0, 1.0] when converting from unsigned or signed datatypes, respectively. If the input image has a float type, intensity values are not modified and can be outside the ranges [0.0, 1.0] or [-1.0, 1.0]. )rjr rMror r rrsrcCrn)aConvert an image to 16-bit unsigned integer format. Parameters ---------- image : ndarray Input image. force_copy : bool, optional Force a copy of the data, irrespective of its current dtype. Returns ------- out : ndarray of uint16 Output image. Notes ----- Negative input values will be clipped. Positive values are scaled between 0 and 65535. )rjr uint16ror r rrrcCrn)aConvert an image to 16-bit signed integer format. Parameters ---------- image : ndarray Input image. force_copy : bool, optional Force a copy of the data, irrespective of its current dtype. Returns ------- out : ndarray of int16 Output image. Notes ----- The values are scaled between -32768 and 32767. If the input data-type is positive-only (e.g., uint8), then the output image will still only have positive values. )rjr int16ror r rrsrcCrn)aConvert an image to 8-bit unsigned integer format. Parameters ---------- image : ndarray Input image. force_copy : bool, optional Force a copy of the data, irrespective of its current dtype. Returns ------- out : ndarray of ubyte (uint8) Output image. Notes ----- Negative input values will be clipped. Positive values are scaled between 0 and 255. )rjr uint8ror r rrrrrcCs t|t|S)aConvert an image to boolean format. Parameters ---------- image : ndarray Input image. force_copy : bool, optional Force a copy of the data, irrespective of its current dtype. Returns ------- out : ndarray of bool (`bool_`) Output image. Notes ----- The upper half of the input dtype's positive range is True, and the lower half is False. All negative values (if present) are False. )rjboolror r rr s r )F)r)T)FF)-numpyr warningsr__all__byteubyteshortushortintcuintcr/int_r0longlong ulonglong_integer_types_integer_rangesrubool_bool8floatfloat_float16rRrHrupdatelistkeysrPr r#r.rGrjrm__doc__rrrrrrr r r r rsN         H >