imregionalmax

Máximos regionales

Sintaxis

BW = imregionalmax(I)

BW = imregionalmax(I,conn)

Descripción

BW = imregionalmax(I) devuelve la imagen binaria BW que identifica los máximos regionales en la imagen en escala de grises I. Los máximos regionales son componentes conectados de píxeles con un valor de intensidad constante, rodeados de píxeles con un valor inferior.

BW = imregionalmax(I,conn) especifica la conectividad de los píxeles conn.

Ejemplos

Encontrar los máximos regionales en una imagen de muestra sencilla

Cree una imagen de muestra sencilla con varios máximos regionales.

A = 10*ones(10,10);
A(2:4,2:4) = 22; 
A(6:8,6:8) = 33; 
A(2,7) = 44;
A(3,8) = 45;
A(4,9) = 44

A = 10×10

    10    10    10    10    10    10    10    10    10    10
    10    22    22    22    10    10    44    10    10    10
    10    22    22    22    10    10    10    45    10    10
    10    22    22    22    10    10    10    10    44    10
    10    10    10    10    10    10    10    10    10    10
    10    10    10    10    10    33    33    33    10    10
    10    10    10    10    10    33    33    33    10    10
    10    10    10    10    10    33    33    33    10    10
    10    10    10    10    10    10    10    10    10    10
    10    10    10    10    10    10    10    10    10    10

Encuentre los máximos regionales. Observe que el resultado incluye los máximos regionales en (3,8).

regmax = imregionalmax(A)

regmax = 10x10 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   1   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

Argumentos de entrada

I — Imagen en escala de grises

Arreglo numérico

Imagen en escala de grises, especificada como arreglo numérico de cualquier dimensión.

Ejemplo: I = imread('cameraman.tif');

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

conn — Conectividad de píxeles

4 | 8 | 6 | 18 | 26 | Matriz de 3 por 3 por ... por 3 con valores 0 y 1

Conectividad de píxeles, especificada como uno de los siguientes valores de la tabla. La conectividad por defecto es 8 para imágenes 2D y 26 para imágenes 3D.

Valor	Significado
Conectividades bidimensionales
4	Los píxeles se consideran conectados si comparten bordes. El entorno de un píxel son los píxeles adyacentes en las direcciones horizontal y vertical.	El píxel actual se muestra en gris.
8	Los píxeles se consideran conectados si comparten bordes o vértices. El entorno de un píxel son los píxeles adyacentes en las direcciones horizontal, vertical y diagonal.	El píxel actual se muestra en gris.
Conectividades tridimensionales
6	Los píxeles se consideran conectados si comparten caras. El entorno de un píxel son los píxeles adyacentes en: Alguna de estas direcciones: adentro, afuera, izquierda, derecha, arriba y abajo	El píxel actual se muestra en gris.
18	Los píxeles se consideran conectados si sus caras o bordes se tocan. El entorno de un píxel son los píxeles adyacentes en: Alguna de estas direcciones: adentro, afuera, izquierda, derecha, arriba y abajo Una combinación de dos direcciones, como derecha-abajo o adentro-arriba	El píxel actual es el centro del cubo.
26	Los píxeles se consideran conectados si sus caras, bordes o vértices se tocan. El entorno de un píxel son los píxeles adyacentes en: Alguna de estas direcciones: adentro, afuera, izquierda, derecha, arriba y abajo Una combinación de dos direcciones, como derecha-abajo o adentro-arriba Una combinación de tres direcciones, como adentro-derecha-arriba o adentro-izquierda-abajo	El píxel actual es el centro del cubo.

En el caso de dimensiones más grandes, imregionalmax utiliza el valor por defecto conndef(ndims(I),"maximal").

La conectividad también puede definirse de una forma más general para cualquier dimensión especificando una matriz de 3 por 3 por ... por 3 con valores 0 y 1. Los elementos con el valor 1 definen los entornos relativos al elemento central de conn. Tenga en cuenta que conn debe ser simétrica respecto de su elemento central. Para obtener más información, consulte Especificar conectividades personalizadas.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Argumentos de salida

BW — Ubicación de los máximos regionales

Arreglo lógico

Ubicación de los máximos regionales, devueltos como arreglo lógico del mismo tamaño que I. Los píxeles con el valor 1 indican los máximos regionales; todos los demás píxeles tienen el valor 0.

Tipos de datos: logical

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• imregionalmax es compatible con la generación de código C (requiere MATLAB^® Coder™). Tenga en cuenta que, si selecciona la plataforma objetivo genérica MATLAB Host Computer, imregionalmax genera código que utiliza una biblioteca compartida precompilada específica de la plataforma. El uso de una biblioteca compartida mantiene las optimizaciones de rendimiento, pero limita las plataformas objetivo para las que se puede generar código. Para obtener más información, consulte Types of Code Generation Support in Image Processing Toolbox.

• A la hora de generar código, el segundo argumento de entrada opcional conn debe ser una constante en tiempo de compilación.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con los entornos basados en hilos. Para obtener más información, consulte Ejecutar funciones de MATLAB en un entorno basado en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

Notas y limitaciones de uso:

• Las entradas deben ser 2D y únicamente son compatibles las conectividades 2D (4 y 8).

Para obtener más información, consulte Procesamiento de imágenes en una GPU.

Historial de versiones

Introducido antes de R2006a

R2022b: Compatibilidad con entornos basados en hilos

Ahora imregionalmax es compatible con los entornos basados en hilos.

Consulte también

conndef | imextendedmax | imhmax | imreconstruct | imregionalmin