label2rgb

Convertir una matriz de etiquetas en una imagen RGB

Sintaxis

RGB = label2rgb(L)

RGB = label2rgb(L,cmap)

RGB = label2rgb(L,cmap,zerocolor)

RGB = label2rgb(L,cmap,zerocolor,colorAssignment)

RGB = label2rgb(___,OutputFormat=outputFormat)

Descripción

RGB = label2rgb(L) convierte una imagen de etiqueta L en una imagen de color RGB con el fin de visualizar las regiones etiquetadas. La función label2rgb determina el color que debe asignarse a cada objeto en función del número de objetos de la matriz de etiquetas. La función label2rgb elige los colores de toda la gama del mapa de colores.

RGB = label2rgb(L,cmap) especifica el mapa de colores cmap que se utilizará en la imagen RGB.

RGB = label2rgb(L,cmap,zerocolor) especifica el color RGB de los elementos de fondo (píxeles etiquetados 0).

RGB = label2rgb(L,cmap,zerocolor,colorAssignment) controla cómo label2rgb asigna los colores a las regiones en la matriz de etiquetas.

RGB = label2rgb(___,OutputFormat=outputFormat) le permite especificar que la función devuelva una lista de colores únicos en lugar de una imagen RGB.

En las versiones anteriores a la R2021a, utilice la sintaxis equivalente RGB = label2rgb(__,"OutputFormat",outputFormat)

Ejemplos

Usar el color para resaltar los elementos en la matriz de etiquetas

Lea y muestre una imagen.

I = imread("rice.png"); 
imshow(I)

Cree una matriz de etiquetas a partir de la imagen.

BW = imbinarize(I); 
CC = bwconncomp(BW);
L = labelmatrix(CC);

Convierta la matriz de etiquetas en una imagen RGB utilizando los ajustes predeterminados. Los píxeles del fondo son blancos.

RGB = label2rgb(L);
imshow(RGB)

Convierta la matriz de etiquetas en una imagen RGB, especificando parámetros opcionales. Este ejemplo utiliza el mapa de colores "spring", establece los píxeles de fondo en el color cian, y aleatoriza la forma de asignar los colores a las etiquetas.

RGB2 = label2rgb(L,"spring","c","shuffle"); 
imshow(RGB2)

Argumentos de entrada

L — Imagen de la etiqueta

Matriz de enteros no negativos | matriz categórica

Imagen de la etiqueta de regiones contiguas, especificada como uno de los siguientes.

• Una matriz de enteros no negativos. 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. Puede obtener una imagen de etiqueta numérica a partir de funciones de etiquetado como watershed o labelmatrix.

• Una matriz categórica.

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

cmap — Mapa de colores

"jet" (predeterminado) | Matriz de c por 3 | función de mapa de colores | Identificador

Mapa de colores que utilizar en la imagen RGB en color generada, especificado con uno de los siguientes.

Valor	Descripción
Matriz de c por 3 del tipo de datos double	Matriz de mapa de colores que especifica c colores, cada uno como un triplete RGB. c debe ser mayor o igual que el número de etiquetas, numlabels, en la matriz de etiquetas L. Se puede calcular el número de etiquetas como numlabels = max(L(:)). Si c es mayor que numlabels, label2rgb crea la imagen RGB utilizando solo las primeras numlabels filas de la matriz.
función de mapa de colores	Nombre de una función de mapa de colores de MATLAB®, como "jet" o "gray". Consulte colormap para ver una lista de mapas de colores compatibles.
identificador de mapas de colores	Identificador de una función de mapa de colores, como @jet o @gray.

zerocolor — Color de relleno

[1 1 1] (blanco) (predeterminado) | Vector de 3 elementos | "b" | "c" | "g"

Color de relleno, especificado como un vector de 3 elementos que representa un triplete RGB o una de las siguientes abreviaturas de color para imágenes de etiquetas numéricas. label2rgb aplica el color de relleno a la etiqueta 0 para las imágenes de etiquetas numéricas o a la etiqueta <undefined> para las imágenes de etiquetas categóricas.

Valor	Color
"b"	Azul
"c"	Cian
"g"	Verde
"k"	Negro
"m"	Magenta
"r"	Rojo
"w"	Blanco
"y"	Amarillo

colorAssignment — Asignación de colores

"noshuffle" (predeterminado) | "shuffle" | "contrasting-neighbors"

Asignación de colores, especificada como uno de estos valores.

• "noshuffle": asigna los colores del mapa de colores para etiquetar regiones de la matriz en orden numérico. Cada región tiene un color único.

• "shuffle": asigna los colores del mapa de colores de forma pseudoaleatoria. Cada región tiene un color único.

• "contrasting-neighbors" (desde R2025a): asigna un subconjunto de colores del mapa de colores para maximizar el contraste entre regiones adyacentes. Cada color puede corresponder a varias etiquetas.

outputFormat — Formato de salida

"image" (predeterminado) | "triplets"

Formato de salida de los datos RGB devueltos en RGB, especificado como uno de los siguientes.

• "image": devuelve una imagen RGB. Si el tamaño de la matriz de etiquetas de entrada L es M por N, el tamaño de la imagen RGB de salida es M por N por 3.

• "triplets": devuelve una lista de colores RGB. El tamaño de la salida es una matriz de C por 3 que contiene un triplete RGB para cada una de las etiquetas C de la matriz de etiquetas de entrada.

Argumentos de salida

RGB — Datos de RGB

Matriz numérica

Datos de RGB, devueltos como una matriz numérica.

Tipos de datos: uint8

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• label2rgb 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.

• Las imágenes de etiqueta de entrada de tipo de datos categóricos no son compatibles.

• Al generar código, para obtener los mejores resultados, utilice la sintaxis estándar RGB = label2rgb(L,cmap,zerocolor,colorAssignment):

  • Envíe al menos dos argumentos de entrada: la matriz de etiquetas L y la matriz de mapa de colores, cmap.

  • cmap debe ser una matriz de c por 3 de tipo de datos double. No puede especificar el nombre de una función de mapa de colores MATLAB o un identificador de función de una función de mapa de colores.

  • Si establece el color de fondo zerocolor al mismo color que una de las regiones, label2rgb no emitirá una advertencia.

  • Si proporciona un valor para colorAssignment, debe ser "noshuffle".

Generación de código de GPU

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

Notas y limitaciones de uso:

• Las imágenes de etiqueta de entrada de tipo de datos categóricos no son compatibles.

• Al generar código, para obtener los mejores resultados, utilice la sintaxis estándar RGB = label2rgb(L,cmap,zerocolor,colorAssignment):

  • Envíe al menos dos argumentos de entrada: la matriz de etiquetas L y la matriz de mapa de colores, cmap.

  • cmap debe ser una matriz de c por 3 de tipo de datos double. No puede especificar el nombre de una función de mapa de colores MATLAB o un identificador de función de una función de mapa de colores.

  • Si establece el color de fondo zerocolor al mismo color que una de las regiones, label2rgb no emitirá una advertencia.

  • Si proporciona un valor para colorAssignment, debe ser "noshuffle".

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.

Historial de versiones

Introducido antes de R2006a

R2025a: Mejorar el contraste de color de las etiquetas adyacentes

Para asegurarse de que las regiones adyacentes tengan colores visualmente distintos, especifique el argumento colorAssignment como el nuevo valor "contrasting-neighbors".

R2022b: Generar código CUDA utilizando GPU Coder

Ahora label2rgb es compatible con la generación de código optimizado CUDA^® (requiere GPU Coder™).

R2021b: Compatibilidad con entornos basados en hilos

Ahora label2rgb es compatible con los entornos basados en hilos.

Consulte también

bwconncomp | bwlabel | bwlabeln | colormap | ismember | labelmatrix | watershed

Temas

• Get Started with Image Segmentation
• Get Started with Semantic Segmentation Using Deep Learning (Computer Vision Toolbox)