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

• Las funciones bwlabel, bwlabeln y bwconncomp calculan componentes conectados para imágenes binarias. bwconncomp sustituye el uso de bwlabel y bwlabeln. Utiliza bastante menos memoria y a veces 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 por defecto, basta con pasar 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 (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 Run MATLAB Functions in Thread-Based Environment.

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 Image Processing on a 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.

Consulte también

bwconncomp | bwlabeln | bwselect | labelmatrix | label2rgb | regionprops

×

Abrir ejemplo

Tiene una versión modificada de este ejemplo. ¿Desea abrir este ejemplo con sus modificaciones?

No, sobrescribir la versión modificada Sí