imhist

Histograma de datos de imagen

Sintaxis

[counts,binLocations] = imhist(I)

[counts,binLocations] = imhist(I,n)

[counts,binLocations] = imhist(X,cmap)

imhist(___)

Descripción

[counts,binLocations] = imhist(I) calcula el histograma de la imagen en escala de grises I. La función imhist devuelve los recuentos del histograma de counts y las ubicaciones de los bins de binLocations. El número de bins del histograma viene determinado por el tipo de imagen.

[counts,binLocations] = imhist(I,n) especifica el número de bins, n, utilizado para calcular el histograma.

[counts,binLocations] = imhist(X,cmap) calcula el histograma de la imagen indexada X con el mapa de colores cmap. El histograma tiene un bin para cada entrada del mapa de colores.

imhist(___) muestra una gráfica del histograma. Si la imagen de entrada es una imagen indexada, el histograma muestra la distribución de los valores de los píxeles sobre una barra de color del mapa de colores cmap.

Ejemplos

Cálculo del histograma

Lea una imagen en escala de grises en el área de trabajo.

I = imread('pout.tif');

Muestre el histograma de la imagen. Dado que I es una imagen en escala de grises, el histograma tendrá, por defecto, 256 bins.

imhist(I)

Visualización del histograma de una imagen de intensidad 3D

Cargue un conjunto de datos 3D.

load mristack

Muestre el histograma de los datos. Dado que se trata de una imagen en escala de grises, imhist utiliza 256 bins por defecto.

imhist(mristack)

Argumentos de entrada

I — Imagen en escala de grises

Arreglo numérico

Imagen en escala de grises, especificada como arreglo numérico de cualquier dimensión. La función imhist espera que las imágenes del tipo de datos double y single tengan valores en el intervalo [0, 1]. Si I tiene valores que se sitúan fuera del intervalo [0, 1], puede usar la función rescale para volver a escalar los valores al intervalo previsto.

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

n — Número de bins

entero positivo

Número de bins, especificado como entero positivo. Si I es una imagen en escala de grises, imhist utiliza un valor por defecto de 256 bins. Si I es una imagen binaria, imhist utiliza dos bins.

Ejemplo: 50

X — Imagen indexada

Arreglo numérico

Imagen indexada, especificada como arreglo numérico de cualquier dimensión.

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

cmap — Mapa de colores

Matriz numérica de c por 3

Mapa de colores asociado a la imagen indexada X, especificado como matriz numérica de c por 3 con valores comprendidos 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. El mapa de colores debe ser al menos tan largo como el mayor índice de X.

Tipos de datos: double

Argumentos de salida

counts — Recuentos de histograma

Arreglo numérico

Recuentos de histograma, devueltos como arreglo numérico. Si el histograma se calcula para una imagen indexada, X, la longitud de counts es la misma que la del mapa de colores, cmap.

binLocations — Ubicaciones de los bins

Arreglo numérico

Ubicaciones de los bins, devueltas como arreglo numérico.

Sugerencias

• En cuanto a las imágenes en escala de grises, los bins n del histograma son, cada uno de ellos, intervalos semiabiertos con un ancho de A/(n−1). En concreto, el bin pth es el intervalo semiabierto

  $$\frac{A(p-1.5)}{(n-1)}-B\le x<\frac{A(p-0.5)}{(n-1)}-B,$$

  en el que x es el valor de la intensidad. El factor escalar A y el desplazamiento B dependen del tipo de datos de la imagen, tal y como figura a continuación:

  Tipo de datos	A	B
  double	1	0
  single	1	0
  int8	255	128
  int16	65,535	32,768
  int32	4,294,967,295	2,147,483,648
  uint8	255	0
  uint16	65,535	0
  uint32	4,294,967,295	0
  logical	1	0

• Para mostrar el histograma de counts y binLocations, utilice el comando stem(binLocations,counts).

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

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

• Si la primera entrada es una imagen binaria, n debe ser una constante escalar de valor 2 en tiempo de compilación.

• Las sintaxis no programáticas no son compatibles. Por ejemplo, la sintaxis imhist(I), en la que imhist muestra el histograma, no es compatible.

Generación de código de GPU

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

Notas y limitaciones de uso:

• Si la primera entrada es una imagen binaria, n debe ser una constante escalar de valor 2 en tiempo de compilación.

• Las sintaxis no programáticas no son compatibles. Por ejemplo, la sintaxis imhist(I), en la que imhist muestra el histograma, no es compatible.

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™.

Notas y limitaciones de uso:

• imhist no es compatible con imágenes indexadas en una GPU.

• Cuando se omiten los argumentos de salida en una GPU, imhist no muestra el histograma. En este caso, la función devuelve los recuentos de histograma de la variable ans y no devuelve las ubicaciones de los bins del histograma.

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 imhist es compatible con los entornos basados en hilos.

Consulte también

histeq | histogram | stem