bwlabel

Etiquetar los componentes conectados de una imagen 2D binaria

Sintaxis

L = bwlabel(BW)

L = bwlabel(BW,conn)

[L,n] = bwlabel(___)

Descripción

L = bwlabel(BW) devuelve la matriz de etiquetas L, que contiene las etiquetas de los 8 objetos conectados que se encuentran en BW.

L = bwlabel(BW,conn) devuelve una matriz de etiquetas, en la que conn especifica la conectividad.

[L,n] = bwlabel(___) también devuelve n, el número de objetos conectados que se encuentran en BW.

Ejemplos

Etiquetar componentes mediante objetos de conectividad 4

Cree una imagen binaria pequeña.

BW = logical ([1     1     1     0     0     0     0     0
               1     1     1     0     1     1     0     0
               1     1     1     0     1     1     0     0
               1     1     1     0     0     0     1     0
               1     1     1     0     0     0     1     0
               1     1     1     0     0     0     1     0
               1     1     1     0     0     1     1     0
               1     1     1     0     0     0     0     0]);

Cree la matriz de etiquetas utilizando objetos de conectividad 4.

L = bwlabel(BW,4)

L = 8×8

     1     1     1     0     0     0     0     0
     1     1     1     0     2     2     0     0
     1     1     1     0     2     2     0     0
     1     1     1     0     0     0     3     0
     1     1     1     0     0     0     3     0
     1     1     1     0     0     0     3     0
     1     1     1     0     0     3     3     0
     1     1     1     0     0     0     0     0

Utilice el comando find para obtener las coordenadas de fila y columna del objeto etiquetado como "2".

[r, c] = find(L==2);
rc = [r c]

rc = 4×2

     2     5
     3     5
     2     6
     3     6

Argumentos de entrada

BW — Imagen binaria

Matriz numérica 2D | Matriz lógica 2D

Imagen binaria, especificada como matriz numérica 2D o matriz lógica 2D. En la entrada numérica, cualquier píxel distinto de cero se considera 1 (true).

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

conn — Conectividad de píxeles

8 (predeterminado) | 4

Conectividad de píxeles, especificada como uno de estos valores.

Valor	Significado
Conectividades bidimensionales
4	Los píxeles se consideran conectados si comparten bordes. Dos píxeles contiguos forman parte del mismo objeto si ambos se encuentran y están conectados a lo largo de la dirección horizontal o vertical.	El píxel actual se muestra en gris.
8	Los píxeles se consideran conectados si comparten bordes o vértices. Dos píxeles contiguos forman parte del mismo objeto si ambos se encuentran y están conectados a lo largo de la dirección horizontal, vertical o diagonal.	El píxel actual se muestra en gris.

Tipos de datos: double | logical

Argumentos de salida

L — Matriz de etiquetas

Matriz de enteros no negativos

Matriz de etiquetas de regiones contiguas, devuelta como matriz de enteros no negativos del mismo tamaño que BW. Los píxeles etiquetados como 0 son el fondo. Los píxeles etiquetados como 1 forman un objeto; los píxeles etiquetados como 2 forman un segundo objeto; y así sucesivamente.

Tipos de datos: double

n — Número de objetos conectados

Entero no negativo

Número de objetos conectados de BW, devuelto como entero no negativo.

Tipos de datos: double

Sugerencias

• Esta función ordena los componentes conectados de izquierda a derecha según el extremo top-left de cada componente. Cuando varios componentes tienen la misma posición horizontal, la función ordena esos componentes de arriba abajo. Esta figura ilustra los extremos de dos regiones diferentes.

• Las funciones bwlabel, bwlabeln y bwconncomp calculan componentes conectados para imágenes binarias. bwconncomp utiliza bastante menos memoria y, en ocasiones, es más rápida que las otras funciones.

  	Dimensión de entrada	Forma de salida	Uso de memoria	Conectividad
  bwlabel	2D	Matriz de etiquetas de doble precisión	Elevada	4 u 8
  bwlabeln	N dimensiones	Matriz de etiquetas de doble precisión	Elevada	Cualquiera
  bwconncomp	N dimensiones	Estructura CC	Baja	Cualquiera

• Puede utilizar la función MATLAB^® find junto con bwlabel para devolver vectores de índices para los píxeles que componen un objeto específico. Por ejemplo, para devolver las coordenadas de los píxeles del objeto 2, introduzca lo siguiente:

  [r,c] = find(bwlabel(BW)==2)

  Puede mostrar la matriz de salida como imagen indexada de pseudocolor. Cada objeto se muestra en un color diferente, por lo que los objetos son más fáciles de distinguir que en la imagen original. Para obtener más información, consulte label2rgb.

• Para extraer características de una imagen binaria utilizando regionprops con la conectividad predeterminada, pase BW directamente a regionprops utilizando el comando regionprops(BW).

• La función bwlabel puede aprovechar la optimización del hardware para los tipos de datos logical, uint8 y single para ejecutarse más rápidamente. La optimización del hardware requiere que marker y mask sean imágenes 2D y que conn sea de conectividad 4 u 8.

Algoritmos

bwlabel utiliza el procedimiento general recogido en la referencia [1], págs. 40-48:

1. Realice la compresión RLE de la imagen de entrada.

2. Escanee las secuencias asignando etiquetas preliminares y registrando las equivalencias de etiquetas en una tabla de equivalencias local.

3. Resuelva las clases de equivalencia.

4. Vuelva a etiquetar las secuencias en función de las clases de equivalencia resueltas.

Referencias

[1] Haralick, Robert M., and Linda G. Shapiro, Computer and Robot Vision, Volume I, Addison-Wesley, 1992, pp. 28-48.

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• bwlabel es compatible con la generación de código C y C++ (requiere MATLAB Coder™). Para obtener más información, consulte Code Generation for Image Processing.

• A la hora de generar código, el parámetro n debe ser una constante en tiempo de compilación.

Generación de código de GPU

Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Notas y limitaciones de uso:

• A la hora de generar código, el parámetro n 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 entornos basados en subprocesos.

Arreglos GPU

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

Esta función es totalmente compatible con los arreglos de GPU. 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 bwlabel es compatible con los entornos basados en hilos.

R2006a: No recomendado

A partir de la versión R2022b, la mayoría de funciones de Image Processing Toolbox™ crean y realizan transformaciones geométricas utilizando la convención de la premultiplicación. Por lo tanto, no se recomienda el objeto affine2d porque utiliza la convención de la posmultiplicación. Aunque no está previsto eliminar el objeto affine2d por el momento, puede simplificar sus flujos de transformación geométrica cambiando al objeto affinetform2d, que es compatible con la convención de la premultiplicación. Para obtener más información, consulte Migrate Geometric Transformations to Premultiply Convention.

Para actualizar su código:

• Cambie las instancias del nombre de la función affine2d a affinetform2d.

• Especifique la matriz de transformación como la traspuesta de la matriz T, donde T es o bien el valor de la propiedad T del objeto affine2d o bien la matriz de transformación usada para crear el objeto affine2d.

Uso no recomendado	Reemplazo recomendado
Este ejemplo crea un objeto affine2d a partir de la matriz de transformación T en la convención de la posmultiplicación. T = [2 0.33 0; 0 1 0; 0 0 1]; tformPost = affine2d(T);	Este ejemplo crea un objeto affinetform2d a partir de la traspuesta de la matriz de transformación T. T = [2 0.33 0; 0 1 0; 0 0 1]; tform = affinetform2d(T'); Este ejemplo empieza con un objeto affine2d llamado tformPost y crea un objeto affinetform2d a partir de la traspuesta de la propiedad T de tformPost. T = tformPost.T; tform = affinetform2d(T');

Consulte también

bwconncomp | bwlabeln | bwselect | labelmatrix | label2rgb | regionprops