skimage2.filters.rank.autolevel_percentile

skimage2.filters.rank.autolevel_percentile(image, footprint, out=None, mask=None, shift_x=0, shift_y=0, p0=0, p1=1)

Return grayscale local autolevel of an image.

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:

imagendarray of shape (M, N) and dtype (uint8 or uint16)

Input image.

footprintndarray of shape (m, n)

The neighborhood expressed as a 2-D array of 1’s and 0’s.

outndarray of shape (M, N), same dtype as input image

If None, a new array is allocated.

maskndarray

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_yint

Offset added to the footprint center point. Shift is bounded to the footprint sizes (center must be inside the given footprint).

p0, p1float, optional, in interval [0, 1]

Define the [p0, p1] percentile interval to be considered for computing the value.

Returns:

outndarray of shape (M, N), same dtype as input image

Output image.