imshow

Mostrar una imagen

Sintaxis

imshow(I)

imshow(I,[low high])

imshow(I,[])

imshow(RGB)

imshow(BW)

imshow(X,map)

imshow(filename)

imshow(___,Name,Value)

himage = imshow(___)

imshow(I,RI)

imshow(X,RX,map)

Descripción

imshow(I) muestra la imagen en escala de grises I en una figura. imshow utiliza el intervalo de visualización predeterminado para el tipo de datos de la imagen y optimiza la figura, los ejes y las propiedades del objeto de imagen para su visualización.

imshow(I,[low high]) muestra la imagen I en escala de grises, especificando el intervalo de visualización como un vector de dos elementos, [low high]. Para obtener más información, consulte el argumento DisplayRange.

imshow(I,[]) muestra la imagen I en escala de grises, escalando la visualización en función del intervalo de valores de los píxeles en I. imshow utiliza [min(I(:)) max(I(:))] como intervalo de visualización. imshow muestra el valor mínimo en I como negro y el valor máximo como blanco. Para obtener más información, consulte el argumento DisplayRange.

imshow(RGB) muestra la imagen RGB en color verdadero en una figura.

imshow(BW) muestra la imagen binaria BW en una figura. Para las imágenes binarias, imshow muestra los píxeles con el valor 0 (cero) como negro y 1 como blanco.

imshow(X,map) muestra la imagen indexada X con el mapa de colores map.

imshow(filename) muestra la imagen almacenada en el archivo gráfico especificado por filename.

imshow(___,Name,Value) muestra una imagen, utilizando pares nombre-valor para controlar aspectos de la operación.

himage = imshow(___) devuelve el objeto de imagen creado por imshow.

imshow(I,RI) muestra la imagen I con el objeto de referencia espacial 2D asociado RI.

imshow(X,RX,map) muestra la imagen indexada X con el objeto de referencia espacial 2D asociado RX y el mapa de colores map.

Ejemplos

Mostrar una imagen RGB, en escala de grises, binaria o indexada

Muestre una imagen RGB (color verdadero), en escala de grises, binaria o indexada utilizando imshow.

Mostrar una imagen RGB

Lea una imagen RGB de muestra, peppers.png, en el espacio de trabajo MATLAB.

rgbImage = imread("peppers.png");

Muestre la imagen RGB utilizando imshow.

imshow(rgbImage)

Mostrar una imagen en escala de grises

Convierta la imagen RGB en una imagen en escala de grises, utilizando la función rgb2gray.

grayImage = rgb2gray(rgbImage);

Muestre la imagen en escala de grises utilizando imshow.

imshow(grayImage)

Mostrar una imagen binaria

Convierte la imagen en escala de grises en una imagen binaria, mediante el uso de umbrales.

meanVal = mean(grayImage,"all");
binaryImage = grayImage >= meanVal;

Muestre la imagen binaria utilizando imshow.

imshow(binaryImage)

Mostrar una imagen indexada

Lea una imagen indexada de muestra, corn.tif, en el espacio de trabajo de MATLAB.

[corn_indexed,map] = imread('corn.tif');

Muestre la imagen indexada utilizando imshow.

imshow(corn_indexed,map)

Mostrar imagen de un archivo

Muestre una imagen guardada en un archivo.

imshow('peppers.png');

Cambiar el mapa de colores de la imagen mostrada

Cargue una imagen de prueba volumétrica en escala de grises, mri.mat, en la variable del espacio de trabajo D. Elimine la dimensión única del volumen utilizando la función squeeze.

load("mri.mat");
vol = squeeze(D);

Seleccione un corte del centro del volumen. Muestre el corte utilizando el mapa de colores copper y escalando el intervalo de visualización al intervalo de valores de los píxeles.

sliceZ = vol(:,:,13);
imshow(sliceZ,[],Colormap=copper)

Cambie el mapa de colores de la imagen utilizando la función colormap.

colormap(hot)

Escalar el intervalo de visualización de la imagen

Lea una imagen en color verdadero (RGB) en el espacio de trabajo. El tipo de datos de la imagen es uint8.

RGB = imread('peppers.png');

Extraiga el canal verde de la imagen. El canal verde es el segundo plano de color.

G = RGB(:,:,2);
imshow(G)

Cree un filtro que detecte los bordes horizontales de la imagen.

filt = [-1 -1 -1;0 0 0;1 1 1];

Filtre el canal verde la imagen utilizando la función filter2. El resultado es una imagen de tipo de datos double con un valor mínimo de -422 y un valor máximo de 656. Los píxeles con una gran magnitud en la imagen filtrada indican bordes intensos.

edgeG = filter2(filt,G);

Muestre la imagen filtrada utilizando imshow con el intervalo de visualización predeterminado. Para las imágenes de tipo de datos double, el intervalo de visualización predeterminado es [0, 1]. La imagen aparece en blanco y negro porque los valores de los píxeles filtrados superan el intervalo [0, 1].

imshow(edgeG)

Muestre la imagen filtrada y escale el intervalo de visualización a los valores de los píxeles de la imagen. La imagen se muestra con toda la gama de valores de la escala de grises.

imshow(edgeG,[])

Aumentar una imagen utilizando el vecino más cercano y la interpolación bilineal

Lea la imagen en escala de grises del archivo corn.tif en el espacio de trabajo. La versión en escala de grises de la imagen es la segunda imagen del archivo.

corn_gray = imread('corn.tif',2);

Seleccione una pequeña sección de la imagen. Muestre la imagen detallada con un aumento del 100% utilizando imshow.

corn_detail = corn_gray(1:100,1:100);
imshow(corn_detail)

Muestre la imagen con un aumento del 1000% utilizando el argumento de par nombre-valor 'InitialMagnification'. Por defecto, inshow realiza la interpolación del vecino más cercano de los valores de los píxeles. La imagen tiene artefactos de bloque.

imshow(corn_detail,'InitialMagnification',1000)

Muestre la imagen con un aumento del 1000%, especificando la técnica de interpolación bilineal. La imagen aparece más suavizada.

imshow(corn_detail,'InitialMagnification',1000,'Interpolation',"bilinear")

Mostrar una imagen utilizando un objeto de referencia espacial asociado

Lea una imagen en el espacio de trabajo.

I = imread('pout.tif');

Muestre la imagen. Observe que los límites de los ejes reflejan el tamaño de la imagen.

figure
imshow(I)

Cree un objeto de referencia espacial asociado a la imagen. Utilice el objeto de referencia para establecer los límites de los ejes X e Y en el sistema de coordenadas mundial.

RI = imref2d(size(I));
RI.XWorldLimits = [0 3];
RI.YWorldLimits = [2 5];

Muestre la imagen, especificando el objeto de referencia espacial. Observe el cambio en los límites de los ejes X e Y.

figure
imshow(I,RI)

Argumentos de entrada

I — Imagen en escala de grises de entrada

matriz

Imagen en escala de grises de entrada, especificada como matriz. Una imagen en escala de grises puede ser cualquier tipo de dato numérico.

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

RGB — Imagen en color verdadero de entrada

Arreglo de m por n por 3

Imagen de entrada en color verdadero, especificada como arreglo de m por n por 3.

Si especifica una imagen en color verdadero con tipo de datos single o double, los valores deben estar en el intervalo [0, 1]. Si hay valores de píxel fuera de este intervalo, se puede usar la función rescale para llevar los valores al intervalo [0, 1]. El argumento 'DisplayRange' no tiene efecto cuando la imagen de entrada es de color verdadero.

Tipos de datos: single | double | uint8 | uint16

BW — Imagen binaria de entrada

matriz

Imagen binaria de entrada, especificada como una matriz.

Tipos de datos: logical

X — Imagen indexada

Matriz 2D de enteros positivos

Imagen indexada, especificada como matriz 2D de enteros positivos. Los valores de X son índices del mapa de colores especificado por map.

Tipos de datos: single | double | uint8 | logical

map — Mapa de colores

Matriz de c por 3

Mapa de colores asociado a la imagen indexada X, especificado como matriz de c por 3. Cada fila de map es un triplete RGB de tres elementos que especifica los componentes rojo, verde y azul de un único color del mapa de colores. Cuando map es del tipo de datos single o double, los valores de la matriz se encuentran en el intervalo [0, 1].

Tipos de datos: single | double | uint8

filename — Nombre del archivo

vector de caracteres

Nombre del archivo, especificado como un vector de caracteres. La imagen debe ser legible por la función imread. La función imshow muestra la imagen, pero no almacena los datos de la misma en el espacio de trabajo de MATLAB^®. Si el archivo contiene varias imágenes, imshow muestra la primera imagen del archivo.

Ejemplo: 'peppers.png'

Tipos de datos: char

[low high] — Intervalo de visualización de imagen en escala de grises

vector de dos elementos

Intervalo de visualización de imagen en escala de grises, especificado como vector de dos elementos. Para obtener más información, consulte el argumento de par nombre-valor 'DisplayRange'.

Ejemplo: [50 250]

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

RI — Objeto de referencia espacial 2D asociado a la imagen de entrada

objeto imref2d

Objeto de referencia espacial 2D asociado a la imagen de entrada, especificado como un objeto imref2d.

RX — Objeto de referencia espacial 2D asociado a la imagen indexada

objeto imref2d

Objeto de referencia espacial 2D asociado a la imagen indexada, especificado como un objeto imref2d.

Argumentos de par nombre-valor

Especifique pares de argumentos opcionales como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos de nombre-valor deben aparecer después de otros argumentos. Sin embargo, el orden de los pares no importa.

En las versiones anteriores a la R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas.

Ejemplo: imshow('board.tif','Border','tight')

Border — Espacio del borde de la ventana de la figura

'loose' (predeterminado) | 'tight'

Espacio del borde de la ventana de la figura, especificado como el par separado por comas que consta de 'Border' y 'tight' o 'loose'. Cuando se establece en 'loose', la ventana de la figura incluye el espacio alrededor de la imagen en la figura. Cuando se establece en 'tight', la ventana de la figura no incluye ningún espacio alrededor de la imagen en la figura.

Si la imagen es muy pequeña o si la figura contiene otros objetos además de una imagen y sus ejes, imshow podría utilizar un borde independientemente de cómo se establezca este parámetro.

Tipos de datos: char

Colormap — Mapa de colores

Matriz de c por 3

Mapa de colores, especificado como el par separado por comas que consta de 'Colormap' y una matriz de c por 3 con valores en el intervalo [0, 1]. Cada fila de la matriz es un triplete RGB de tres elementos que especifica los componentes rojo, verde y azul de un único color del mapa de colores. Utilice este argumento para ver las imágenes en escala de grises en falso color. Si especifica un mapa de colores vacío ([]), la función imshow ignora este argumento.

Ejemplo: cmap = copper; imshow('board.tif','Colormap',cmap)

Tipos de datos: double

DisplayRange — Intervalo de visualización de imagen en escala de grises

vector de dos elementos | []

Intervalo de visualización de imagen en escala de grises, especificado como un vector de dos elementos de la forma [low high]. La función imshow muestra el valor low (y cualquier valor menor que low) como negro, y muestra el valor high (y cualquier valor mayor que high) como blanco. Los valores entre low y high se muestran como tonos de gris intermedios, utilizando el número de niveles de gris predeterminado.

Si se especifica una matriz vacía ([]), imshow utiliza un intervalo de visualización de [min(I(:)) max(I(:))]. En otras palabras, el valor mínimo en I es negro, y el valor máximo es blanco.

Si no especifica un intervalo de visualización, imshow selecciona un intervalo de visualización predeterminado basado en el tipo de datos de la imagen.

• Si I es un tipo entero, DisplayRange tiene por defecto los valores mínimos y máximos representables para esa clase de entero. Por ejemplo, el intervalo de visualización predeterminado para los arreglos uint16 es [0, 65535].

• Si I es del tipo de datos single o double, el intervalo de visualización predeterminado es [0, 1].

Nota

Incluir el nombre del parámetro es opcional, excepto cuando la imagen se especifica mediante un nombre de archivo. La sintaxis imshow(I,[low high]) es equivalente a imshow(I,'DisplayRange',[low high]). Si llama a imshow con un nombre de archivo, entonces debe especificar el parámetro 'DisplayRange'.

Ejemplo: 'DisplayRange',[10 250]

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

InitialMagnification — Aumento inicial de la visualización de la imagen

100 (predeterminado) | Escalar numérico | 'fit'

Aumento inicial de la visualización de la imagen, especificada como el par separado por comas que consta de 'InitialMagnification' y un escalar numérico o 'fit'. Si se establece en 100, imshow muestra la imagen con un aumento del 100% (un píxel de la pantalla por cada píxel de la imagen). Si se establece en 'fit', imshow escala toda la imagen para que quepa en la ventana.

Inicialmente, imshow intenta mostrar toda la imagen con el aumento especificado. Si el valor de aumento es tan grande que la imagen es demasiado grande para mostrarla en la pantalla, imshow muestra la imagen con el mayor aumento que quepa en la pantalla.

Si la imagen se muestra en una figura con su propiedad 'WindowStyle' establecida en 'docked', imshow muestra la imagen con el mayor aumento que quepa en la figura.

Nota: Si especifica la posición de los ejes, imshow ignora cualquier aumento inicial que haya especificado y adopta por defecto el comportamiento 'fit'.

Cuando utilice imshow con el parámetro 'Reduce', el aumento inicial debe ser 'fit'.

En MATLAB Online™, 'InitialMagnification' se establece en 'fit' y no se puede cambiar.

Ejemplo: 'InitialMagnification',80

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

Interpolation — Técnica de interpolación

'nearest' (predeterminado) | 'bilinear'

Método de interpolación, especificado como 'nearest' o 'bilinear'. MATLAB utiliza la interpolación para mostrar una versión escalada de la imagen en su pantalla. El valor que elija no afecta a los datos de la imagen. Elija un método de interpolación en función del contenido de la imagen y del efecto que quiera conseguir:

• 'nearest': interpolación del vecino más cercano. El valor de un píxel situado en (x, y) es el valor del píxel más cercano a (x, y) en la imagen original. Este método es el mejor cuando hay un pequeño número de valores de píxeles que representan categorías distintas, o cuando desea ver píxeles individuales en una vista muy ampliada.

• 'bilinear': interpolación bilineal. El valor de un píxel situado en (x, y) es una media ponderada de los píxeles circundantes en la imagen original. Para minimizar los artefactos de visualización, la función imshow realiza un anti-aliasing cuando se reduce la imagen. Este método es el mejor en casi todas las demás situaciones.

Parent — Ejes principales del objeto de imagen

objeto Axes | objeto UIAxes

Ejes principales del objeto de imagen, especificados como el par separado por comas que consta de 'Parent' y un objeto Axes o UIAxes. Utilice el argumento nombre-valor 'Parent' para crear una interfaz de usuario que le permita controlar las propiedades de Figure y Axes.

Reduce — Indicador de submuestreo

true | false | 1 | 0

Indicador de submuestreo de la imagen, especificado como el par separado por comas que consta de 'Reduce' y true, false, 1 o 0. Este argumento solo es válido cuando se utiliza con el nombre de un archivo TIFF. Utilice el argumento Reduce para mostrar vistas generales de imágenes muy grandes.

Tipos de datos: logical

XData — Límites del eje X del sistema de coordenadas no predeterminado

vector de dos elementos

Límites del eje X del sistema de coordenadas no predeterminado, especificados como el par separado por comas que consta de 'XData' y un vector de dos elementos. Este argumento establece un sistema de coordenadas espaciales no predeterminado especificando los XData de la imagen. El valor puede tener más de dos elementos, pero imshow solo utiliza el primero y el último.

Ejemplo: 'XData',[100 200]

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

YData — Límites del eje Y del sistema de coordenadas no predeterminado

vector de dos elementos

Límites del eje Y del sistema de coordenadas no predeterminado, especificados como el par separado por comas que consta de 'YData' y un vector de dos elementos. El valor puede tener más de dos elementos, pero imshow solo utiliza el primero y el último.

Ejemplo: 'YData',[100 200]

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

Argumentos de salida

himage — Imagen creada por imshow

Objeto de imagen

Imagen creada por imshow, especificada como objeto de imagen.

Sugerencias

• Para cambiar el mapa de colores después de crear la imagen, utilice el comando colormap.

• Puede mostrar varias imágenes con diferentes mapas de colores en la misma figura utilizando imshow con las funciones tiledlayout y nexttile.

• Puede crear un eje sobre los ejes creados por imshow mediante el uso del comando hold on después de llamar a imshow.

• Puede usar la app Image Viewer, que presenta un entorno integrado para visualizar imágenes y realizar algunas tareas comunes de procesamiento de imágenes.

• Puede establecer preferencias de Image Processing Toolbox™ que modifiquen el comportamiento de imshow utilizando la función iptsetpref.

• La opción imshow no es compatible cuando inicia MATLAB con la opción -nojvm.

Capacidades ampliadas

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:

• Esta función acepta arreglos de la GPU, pero no se ejecuta en una GPU.

Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Notas y limitaciones de uso:

• Esta función opera sobre arreglos distribuidos, pero se ejecuta en el cliente MATLAB.

Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

Consulte también

imread | image | imagesc | imwrite | imfinfo | iptsetpref | colormap

Temas

• Image Types in the Toolbox

×

Abrir ejemplo

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

No, sobrescribir la versión modificada Sí