papyri
{ } Raw JSON

bundles / skimage 0.26.1rc0.dev0+git20260530.b607368ff / skimage / morphology / binary / binary_opening

function

skimage.morphology.binary:binary_opening

source: /dev/scikit-image/src/skimage/morphology/binary.py :221

Signature

def   binary_opening ( image ,  footprint = None ,  out = None ,  * ,  mode = ignore )

Summary

Return fast binary morphological opening of an image.

Extended Summary

This function returns the same result as grayscale opening but performs faster for binary images.

The morphological opening on an image is defined as an erosion followed by a dilation. Opening can remove small bright spots (i.e. "salt") and connect small dark cracks. This tends to "open" up (dark) gaps between (bright) features.

Parameters

image : ndarray

Binary input image.

footprint : ndarray or tuple, optional

The neighborhood expressed as a 2-D array of 1's and 0's. If None, use a cross-shaped footprint (connectivity=1). The footprint can also be provided as a sequence of smaller footprints as described in the notes below.

out : ndarray of bool, optional

The array to store the result of the morphology. If None is passed, a new array will be allocated.

mode : str, optional

The mode parameter determines how the array borders are handled. Valid modes are: 'max', 'min', 'ignore'. If 'ignore', pixels outside the image domain are assumed to be True for the erosion and False for the dilation, which causes them to not influence the result. Default is 'ignore'.

Returns

opening : ndarray of bool

The result of the morphological opening.

Notes

The footprint can also be a provided as a sequence of 2-tuples where the first element of each 2-tuple is a footprint ndarray and the second element is an integer describing the number of times it should be iterated. For example footprint=[(np.ones((9, 1)), 1), (np.ones((1, 9)), 1)] would apply a 9x1 footprint followed by a 1x9 footprint resulting in a net effect that is the same as footprint=np.ones((9, 9)), but with lower computational cost. Most of the builtin footprints such as skimage.morphology.disk provide an option to automatically generate a footprint sequence of this type.

See also

skimage.morphology.isotropic_opening

Aliases

  • skimage.morphology.binary_opening