Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

imhmax

H-maxima transform

Syntax

I2 = imhmax(I,h)
I2 = imhmax(I,h,conn)

Description

example

I2 = imhmax(I,h) suppresses all maxima in the intensity image I whose height is less than h, where h is a scalar. Regional maxima are connected components of pixels with a constant intensity value, and whose external boundary pixels all have a lower value. By default, imhmax uses 8-connected neighborhoods for 2-D images, and 26-connected neighborhoods for 3-D images. For higher dimensions, imhmax uses conndef(ndims(I),'maximal').

I2 = imhmax(I,h,conn) computes the H-maxima transform, where conn specifies the connectivity.

Examples

collapse all

Create simple sample array of zeros with several maxima.

a = zeros(10,10);
a(2:4,2:4) = 3;  
a(6:8,6:8) = 8
a = 

     0     0     0     0     0     0     0     0     0     0
     0     3     3     3     0     0     0     0     0     0
     0     3     3     3     0     0     0     0     0     0
     0     3     3     3     0     0     0     0     0     0
     0     0     0     0     0     0     0     0     0     0
     0     0     0     0     0     8     8     8     0     0
     0     0     0     0     0     8     8     8     0     0
     0     0     0     0     0     8     8     8     0     0
     0     0     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0     0     0

Calculate the maxima equal to 4 or more. Note how the area of the image set to 3 is not included.

b = imhmax(a,4)
b = 

     0     0     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0     0     0
     0     0     0     0     0     4     4     4     0     0
     0     0     0     0     0     4     4     4     0     0
     0     0     0     0     0     4     4     4     0     0
     0     0     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0     0     0

Input Arguments

collapse all

Input array, specified as a nonsparse numeric array of any dimension.

Example: I = imread(‘glass.png'); BW = imhmax(I,80);

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

h-maxima transform, specified as a nonnegative scalar.

Example: b = imhmax(a,4);

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Connectivity, specified as a one of the scalar values in the following table. By default, imhmax uses 8-connected neighborhoods for 2-D images and 26-connected neighborhoods for 3-D images. For higher dimensions, imhmax uses conndef(numel(size(I)),'maximal'). Connectivity can be defined in a more general way for any dimension by using for conn a 3-by-3-by- ...-by-3 matrix of 0s and 1s. The 1-valued elements define neighborhood locations relative to the center element of conn. Note that conn must be symmetric around its center element.

Value

Meaning

Two-dimensional connectivities

4

4-connected neighborhood

8

8-connected neighborhood

Three-dimensional connectivities

6

6-connected neighborhood

18

18-connected neighborhood

26

26-connected neighborhood

Example: b = imhmax(a,4,4);

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Output Arguments

collapse all

Transformed image, returned as a nonsparse numeric array of any class, the same size as I.

References

[1] Soille, P., Morphological Image Analysis: Principles and Applications, Springer-Verlag, 1999, pp. 170-171.

Extended Capabilities

Introduced before R2006a

Was this topic helpful?