`skimage.filters.rank._percentile:autolevel_percentile`

source: /dev/scikit-image/src/skimage/filters/rank/_percentile.py :68

Signature

   def     autolevel_percentile (    image    ,    footprint    ,    out    =  None   ,    mask    =  None   ,    shift_x    =  0   ,    shift_y    =  0   ,    p0    =  0   ,    p1    =  1     )

Summary

Return grayscale local autolevel of an image.

Extended Summary

This filter locally stretches the histogram of grayvalues to cover the entire range of values from "white" to "black".

Only grayvalues between percentiles [p0, p1] are considered in the filter.

Parameters

image : ndarray of shape (M, N) and dtype (uint8 or uint16): Input image.
footprint : ndarray of shape (m, n): The neighborhood expressed as a 2-D array of 1's and 0's.
out : ndarray of shape (M, N), same dtype as input `image`: If None, a new array is allocated.
mask : ndarray: Mask array that defines (>0) area of the image included in the local neighborhood. If None, the complete image is used (default).
shift_x, shift_y : int: Offset added to the footprint center point. Shift is bounded to the footprint sizes (center must be inside the given footprint).
p0, p1 : float, optional, in interval [0, 1]: Define the [p0, p1] percentile interval to be considered for computing the value.

Returns

out : ndarray of shape (M, N), same dtype as input `image`: Output image.

Aliases

skimage.filters.rank.autolevel_percentile