imadjust

Ajustar los valores de intensidad de una imagen o un mapa de colores

Sintaxis

J = imadjust(I)

J = imadjust(I,[low_in high_in])

J = imadjust(I,[low_in high_in],[low_out high_out])

J = imadjust(I,[low_in high_in],[low_out high_out],gamma)

J = imadjust(RGB,[low_in high_in],___)

newcmap = imadjust(cmap,[low_in high_in],___)

Descripción

J = imadjust(I) asigna los valores de intensidad de la imagen en escala de grises I a los nuevos valores de J. Cuando se utiliza esta sintaxis, imadjust satura el 1% inferior y el 1% superior de todos los valores de los píxeles. La función asigna linealmente valores de los píxeles entre los límites de saturación a valores entre 0 y 1. Esta operación incrementa el contraste de la imagen de salida J.

Esta sintaxis es equivalente a imadjust(I,stretchlim(I)).

J = imadjust(I,[low_in high_in]) asigna los valores de intensidad de I a los nuevos valores de J para que los valores que se encuentran entre low_in y high_in se asignen linealmente a valores entre 0 y 1.

J = imadjust(I,[low_in high_in],[low_out high_out]) asigna los valores de intensidad de I a los nuevos valores de J para que los valores que se encuentran entre low_in y high_in se asignen linealmente a valores entre low_out y high_out.

J = imadjust(I,[low_in high_in],[low_out high_out],gamma) asigna los valores de intensidad de I a los nuevos valores de J, en los que gamma especifica la forma de la curva que describe la relación entre los valores de I y J.

J = imadjust(RGB,[low_in high_in],___) asigna los valores de la imagen en color verdadero RGB a los nuevos valores de J. Se puede aplicar la misma asignación a todos los canales de color o asignaciones únicas para cada canal.

newcmap = imadjust(cmap,[low_in high_in],___) asigna los valores del mapa de colores cmap a los nuevos valores de newcmap. Se puede aplicar la misma asignación a todos los canales de color o asignaciones únicas para cada canal.

Ejemplos

Ajustar el contraste de una imagen en escala de grises

Lea una imagen en escala de grises de bajo contraste en el área de trabajo y muéstrela en pantalla.

I = imread('pout.tif');
imshow(I)

Ajuste el contraste de la imagen para que el 1% de los datos se sature en las intensidades bajas y las elevadas, y muéstrela.

J = imadjust(I);
figure
imshow(J)

Ajustar el contraste de una imagen en escala de grises especificando los límites de contraste

Lea una imagen en escala de grises de bajo contraste en el área de trabajo y muéstrela en pantalla.

I = imread('pout.tif');
imshow(I);

Ajuste el contraste de la imagen y especifique los límites de contraste.

K = imadjust(I,[0.3 0.7],[]);
figure
imshow(K)

Ajustar el contraste de una imagen a color

Lea una imagen RGB en el área de trabajo y muéstrela.

RGB = imread('football.jpg');
imshow(RGB)

Ajuste el contraste de la imagen RGB y especifique los límites de contraste.

RGB2 = imadjust(RGB,[.2 .3 0; .6 .7 1],[]);
figure
imshow(RGB2)

Estirar una imagen según la desviación estándar

Lea una imagen en el área de trabajo y muéstrela.

I = imread('pout.tif');
imshow(I)

Calcule la desviación estándar y la media de la imagen para estirarla.

n = 2;  
Idouble = im2double(I); 
avg = mean2(Idouble);
sigma = std2(Idouble);

Ajuste el contraste basado en la desviación estándar.

J = imadjust(I,[avg-n*sigma avg+n*sigma],[]);

Muestre la imagen ajustada.

imshow(J)

Argumentos de entrada

I — Imagen en escala de grises

Matriz numérica de m por n

Imagen en escala de grises, especificada como matriz numérica de m por n. Si I es un tipo de datos entero, imadjust primero escala los valores de los píxeles al intervalo [0, 1] mediante im2double. Después de ajustar el contraste aplicando los valores entre los límites de contraste de entrada y de salida, la función convierte la imagen de salida al tipo de datos original de I.

Tipos de datos: single | double | int16 | uint8 | uint16

RGB — Imagen en color verdadero

Arreglo numérico de m por n por 3

Imagen en color verdadero, especificada como arreglo numérico de m por n por 3. Si RGB es un tipo de datos entero, imadjust primero escala los valores de los píxeles al intervalo [0, 1] mediante im2double. Después de ajustar el contraste aplicando los valores entre los límites de contraste de entrada y de salida, la función convierte la imagen de salida al tipo de datos original de RGB.

Tipos de datos: single | double | int16 | uint8 | uint16

cmap — Mapa de colores

Matriz numérica de c por 3

Mapa de colores, especificado como matriz numérica de c por 3 con valores en el intervalo [0, 1]. Cada fila es un triplete RGB que especifica los componentes rojo, verde y azul de un único color del mapa de colores.

Tipos de datos: double

[low_in high_in] — Límites de contraste para la imagen de entrada

Vector numérico de 2 elementos | Matriz numérica de 2 por 3

Límites de contraste para la imagen de entrada, especificados como uno de los valores de la tabla.

Tipo de datos de entrada	Valor	Descripción
Imagen en escala de grises	Vector de 1 por 2 de la forma [low_in high_in]	Especifica los límites de contraste de la imagen en escala de grises de entrada que desea asignar a los valores de la imagen de salida. Los valores deben estar en el intervalo [0 1.0]. El valor low_in debe ser menor que el valor high_in.
Imagen en escala de grises	Sin especificar	Si especifica solo el argumento de entrada utilizando la sintaxis imadjust(I), la función establece low_in y high_in basándose en los valores de la imagen de entrada, de modo que el 1% inferior y el 1% superior de todos los valores de los píxeles quedan saturados.
Imagen RGB o mapa de colores	Vector de 2 por 3 de la forma [low_RGB_triplet; high_RGB_triplet]	Especifica los límites de contraste de la imagen RGB o mapa de colores de entrada que desea asignar a los valores de la imagen o al mapa de colores de salida. Cada fila del arreglo es un triplete de color RGB. Los valores deben estar en el intervalo [0 1]. El valor low_RGB_triplet debe ser menor que el valor high_RGB_triplet.
Imagen RGB o mapa de colores	Vector de 1 por 2 de la forma [low_in high_in]	Especifica los límites de contraste de la imagen RGB de entrada que quiere asignar a los valores de la imagen de salida. Cada valor debe estar en el intervalo [0 1.0]. El valor low_in debe ser menor que el valor high_in. Si se especifica un vector de 1 por 2 con una imagen RGB o un mapa de colores, imadjust aplica el mismo ajuste a cada plano o canal de color.
Cualquier tipo de dato	[]	Si se especifica una matriz vacía ([]), imadjust utiliza los límites [0 1].

La función imadjust recorta los valores por debajo de low_in y por encima de high_in. Los valores por debajo de low_in se asignan a low_out y los valores por arriba de high_in se asignan a high_out.

Tipos de datos: single | double

[low_out high_out] — Límites de contraste para la imagen de salida

[0 1] (predeterminado) | Vector numérico de 2 elementos | Matriz numérica de 2 por 3

Límites de contraste para la imagen de salida, especificados como uno de los valores de la tabla.

Tipo de datos de entrada	Valor	Descripción
Imagen en escala de grises	Vector de 1 por 2 de la forma [low_out high_out]	Especifica los límites de contraste de la imagen en escala de grises de salida. Cada valor debe estar en el intervalo [0 1].
Imagen RGB o mapa de colores	Vector de 2 por 3 de la forma [low_RGB_triplet; high_RGB_triplet]	Especifica los límites de contraste de la imagen RGB o mapa de colores de salida. Cada fila del arreglo es un triplete de color RGB. Los valores deben estar en el intervalo [0 1].
Imagen RGB o mapa de colores	Vector de 1 por 2 de la forma [low_out high_out]	Especifica los límites de contraste de la imagen de salida. Cada valor debe estar en el intervalo [0 1]. Si se especifica un vector de 1 por 2 con una imagen RGB o un mapa de colores, imadjust aplica el mismo ajuste a cada plano o canal.
Cualquier tipo de dato	Sin especificar o []	Si no se especifican los límites de contraste de salida o se especifica una matriz vacía ([]), imadjust utiliza los límites predeterminados [0 1].

Si high_out es menor que low_out, imadjust invierte la imagen de salida, como en un negativo fotográfico.

Tipos de datos: single | double

gamma — Forma de la curva que describe la relación entre los valores de entrada y los de salida

1 (predeterminado) | Escalar no negativo | Vector de 1 por 3

Forma de la curva que describe la relación entre los valores de entrada y los de salida, especificada como escalar no negativo o vector numérico de 1 por 3.

• Si gamma es menor que 1, imadjust pesa la asignación hacia valores de salida mayores (más claros).

• Si gamma es mayor que 1, imadjust pesa la asignación hacia valores de salida menores (más oscuros).

• Si gamma es un vector de 1 por 3, imadjust aplica una gama única a cada componente o canal de color.

• Si se omite el argumento, gamma por defecto vale 1 (asignación lineal).

Esta gráfica ilustra la forma de las curvas de transformación cuando gamma es menor, igual o mayor que 1. En cada gráfica, el eje x representa los valores de intensidad en la imagen de entrada y el eje y representa los valores de intensidad en la imagen de salida.

Tipos de datos: double

Argumentos de salida

J — Imagen ajustada

Imagen en escala de grises | Imagen RGB

Imagen en escala de grises ajustada, devuelta como imagen en escala de grises o RGB. J tiene el mismo tamaño y la misma clase que la imagen en escala de grises de entrada I o la imagen en color verdadero RGB.

Tipos de datos: single | double | int16 | uint8 | uint16

newcmap — Mapa de colores ajustado

Matriz numérica de c por 3

Mapa de colores ajustado, devuelto como matriz numérica de c por 3 de la misma clase que el mapa de colores de entrada, cmap.

Tipos de datos: single | double

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• imadjust 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, imadjust 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.

• Cuando se genera código, imadjust no es compatible con imágenes indexadas.

Generación de código de GPU

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

Notas y limitaciones de uso:

• Cuando se genera código, imadjust no es compatible con imágenes indexadas.

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

Consulte también

brighten | histeq | stretchlim | lin2rgb | rgb2lin

Temas

• Corrección gamma
• Técnicas de mejora del contraste