imregionalmin
Regional minima
Description
Examples
Create a simple sample array with several regional minima.
A = 10*ones(10,10); A(2:4,2:4) = 3; A(6:8,6:8) = 8
A = 10×10
10 10 10 10 10 10 10 10 10 10
10 3 3 3 10 10 10 10 10 10
10 3 3 3 10 10 10 10 10 10
10 3 3 3 10 10 10 10 10 10
10 10 10 10 10 10 10 10 10 10
10 10 10 10 10 8 8 8 10 10
10 10 10 10 10 8 8 8 10 10
10 10 10 10 10 8 8 8 10 10
10 10 10 10 10 10 10 10 10 10
10 10 10 10 10 10 10 10 10 10
Calculate the regional minima. The function returns a binary image, the same size as the input image, in which pixels with the value 1
represent the regional minima. imregionalmin
sets all other pixels in to 0
.
regmin = imregionalmin(A)
regmin = 10×10 logical array
0 0 0 0 0 0 0 0 0 0
0 1 1 1 0 0 0 0 0 0
0 1 1 1 0 0 0 0 0 0
0 1 1 1 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 1 1 1 0 0
0 0 0 0 0 1 1 1 0 0
0 0 0 0 0 1 1 1 0 0
0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0
Input Arguments
Grayscale image, specified as a numeric array of any dimension.
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
Pixel connectivity, specified as one of the values in this table. The
default connectivity is 8
for 2-D images, and
26
for 3-D images.
Value | Meaning | |
---|---|---|
Two-Dimensional Connectivities | ||
| Pixels are connected if their edges touch. The neighborhood of a pixel are the adjacent pixels in the horizontal or vertical direction. |
Current pixel is shown in gray. |
| Pixels are connected if their edges or corners touch. The neighborhood of a pixel are the adjacent pixels in the horizontal, vertical, or diagonal direction. |
Current pixel is shown in gray. |
Three-Dimensional Connectivities | ||
| Pixels are connected if their faces touch. The neighborhood of a pixel are the adjacent pixels in:
|
Current pixel is shown in gray. |
| Pixels are connected if their faces or edges touch. The neighborhood of a pixel are the adjacent pixels in:
|
Current pixel is center of cube. |
| Pixels are connected if their faces, edges, or corners touch. The neighborhood of a pixel are the adjacent pixels in:
|
Current pixel is center of cube. |
For higher dimensions, imregionalmin
uses the default
value conndef(ndims(I),"maximal")
.
Connectivity can also be
defined in a more general way for any dimension by specifying a 3-by-3-by- ... -by-3 matrix of
0
s and 1
s. The 1
-valued elements
define neighborhood locations relative to the center element of conn
. Note
that conn
must be symmetric about its center element. See Specifying Custom Connectivities for more information.
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
Output Arguments
Locations of regional minima, returned as a logical array of the same size
as I
. Pixels with the value 1
indicate regional maxima; all other pixels are set to
0
.
Data Types: logical
Extended Capabilities
Usage notes and limitations:
imregionalmin
supports the generation of C code (requires MATLAB® Coder™). Note that if you choose the genericMATLAB Host Computer
target platform,imregionalmin
generates code that uses a precompiled, platform-specific shared library. Use of a shared library preserves performance optimizations but limits the target platforms for which code can be generated. For more information, see Types of Code Generation Support in Image Processing Toolbox.When generating code, the optional second input argument,
conn
, must be a compile-time constant.
This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.
Usage notes and limitations:
Inputs must be 2-D, supporting only the 2-D connectivities (4 and 8).
For more information, see Image Processing on a GPU.
Version History
Introduced before R2006aimregionalmin
now supports thread-based
environments.
See Also
conndef
| imextendedmin
| imhmin
| imimposemin
| imreconstruct
| imregionalmax
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: United States.
You can also select a web site from the following list
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)