# mmhmin
Remove basins with contrast less than h.

## Synopsis

y = mmhmin( f, h = 1, Bc = None )

Implemented in Python.

### Input

f | Image Gray-scale (uint8 or uint16) image.
h | Double Contrast parameter. Default: `1`
Bc | Structuring Element Structuring element (connectivity). Default: `None` (3x3 elementary cross)

### Output

y | Image Gray-scale (uint8 or uint16) or binary image.

## Description

mmhmin sup-reconstructs the gray-scale image `f` from the marker created by the addition of the positive integer value `h` to `f`, using the connectivity `Bc`. This operator removes connected basins with contrast less than `h`. This function is very userful for simplifying the basins of the image.

## Examples

Numerical example:

    >>> a = uint8([
        [10,   3,   6,  18,  16,  15,  10],
        [10,   9,   6,  18,   6,   5,  10],
        [10,   9,   9,  15,   4,   9,  10],
        [10,  10,  10,  10,  10,  10,  10]])

    >>> print mmhmin(a,1,mmsebox())

    [[10  4  6 18 16 15 10]
     [10  9  6 18  6  5 10]
     [10  9  9 15  5  9 10]
     [10 10 10 10 10 10 10]]

Signal example:
Image example:

    >>> f = mmreadgray('r4x2_256.tif')

    >>> mmshow(f)

    >>> fb = mmhmin(f,70)

    >>> mmshow(fb)

    >>> mmshow(mmregmin(fb))

f | fb |

mmregmin(fb) |

## Equation

## Source Code

    def mmhmin(f, h=1, Bc=None):
        if Bc is None: Bc = mmsecross()
        g = mmaddm(f,h)
        y = mmsuprec(g,f,Bc);
        return y

## See also

mmsebox | Create a box structuring element.
mmsecross | Diamond structuring element and elementary 3x3 cross.
mmfreedom | Control automatic data type conversion.
mmhmax | Remove peaks with contrast less than h.
mmareaclose | Area closing

[`mmcloserec`] [Up] [`mmvmax`] |
Copyright (c) 2003, Roberto A. Lotufo, UNICAMP-University of Campinas; Rubens C. Machado, CenPRA-Renato Archer Research Center.