hist

(No recomendado) Gráfica de histograma

hist no se recomienda. En su lugar, utilice histogram.

Para obtener más información, incluidas sugerencias sobre la actualización de código, consulte Reemplazar las instancias no recomendadas de hist e histc.

Sintaxis

hist(x)

hist(x,nbins)

hist(x,xbins)

hist(ax,___)

counts = hist(___)

[counts,centers] = hist(___)

Descripción

hist(x) crea una gráfica de barras histograma de los elementos del vector x. Los elementos de x se clasifican en 10 bins equidistantes a lo largo del eje x entre los valores mínimo y máximo de x. hist muestra los bins como rectángulos, de forma que la altura de cada rectángulo indica el número de elementos del bin.

Si la entrada es un arreglo de varias columnas, hist crea histogramas para cada columna de x y los superpone en una sola gráfica.

Si la entrada es del tipo de datos categorical, cada bin es una categoría de x.

hist(x,nbins) ordena x en el número de bins especificado por el escalar nbins.

hist(x,xbins) ordena x en bins con intervalos o categorías determinados por el vector xbins.

• Si xbins es un vector de valores equidistantes, hist utiliza los valores como centros de bins.

• Si xbins es un vector de valores no equidistantes, hist utiliza los puntos medios entre valores consecutivos como los bordes del bin.

• Si x es del tipo de datos categorical, xbins debe ser un vector categórico o un arreglo de celdas de vectores de caracteres que especifique categorías. hist representa barras solo para esas categorías.

La longitud del vector xbins es igual al número de bins.

hist(ax,___) representa en los ejes especificados por ax en lugar de en los ejes actuales (gca). La opción ax puede preceder a cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

counts = hist(___) devuelve un vector fila, counts, que contiene el número de elementos de cada bin.

[counts,centers] = hist(___) devuelve un vector fila adicional, centers, que indica la ubicación de cada centro de bin en el eje x.

Ejemplos

Histograma de un vector

x = [0 2 9 2 5 8 7 3 1 9 4 3 5 8 10 0 1 2 9 5 10];
hist(x)

hist ordena los valores de x en 10 bins equidistantes entre los valores mínimo y máximo del vector, que son 0 y 10 en este ejemplo.

Histograma de varias columnas

Genere tres columnas de 1000 números aleatorios y represente el histograma con las tres columnas superpuestas.

x = randn(1000,3); 
hist(x)

Los valores de x se ordenan en 10 bins equidistantes entre los valores mínimo y máximo. hist ordena y agrupa las columnas de x por separado y representa cada una de ellas con un color diferente.

Especificar el número de bins del histograma

Represente un histograma de 1000 números aleatorios ordenados en 50 bins equidistantes.

x = randn(1000,1);  
nbins = 50;
hist(x,nbins)

Utilizar hist solo para calcular

Genere 1000 números aleatorios. Cuente los números que hay en cada uno de los 10 bins equidistantes. Devuelva los recuentos y los centros de los bins.

x = randn(1000,1);  
[counts,centers] = hist(x)

counts = 1×10

     4    27    88   190   270   243   123    38    13     4

centers = 1×10

   -2.8915   -2.2105   -1.5294   -0.8484   -0.1673    0.5137    1.1947    1.8758    2.5568    3.2379

Use bar para representar el histograma.

bar(centers,counts)

Especificar los colores del histograma

Genere 1000 números aleatorios y cree un histograma.

data = randn(1000,1);
hist(data)

Obtenga el identificador del objeto de parche que crea la gráfica del histograma.

h = findobj(gca,'Type','patch');

Establezca el color de las barras representadas en un valor de triplete RGB de [0 0.5 0.5]. Establezca el color del borde en blanco.

h.FaceColor = [0 0.5 0.5];
h.EdgeColor = 'w';

Argumentos de entrada

x — Arreglo de entrada

vector o matriz

Vector o matriz de entrada.

• Si x es un vector, hist crea un histograma.

• Si x es una matriz, hist crea un histograma separado para cada columna y representa los histogramas utilizando diferentes colores.

Si el arreglo de entrada contiene valores NaN o categóricos indefinidos, hist no incluye estos valores en los recuentos de bins.

Si el arreglo de entrada contiene los valores infinitos -Inf o Inf, hist ordena -Inf en el primer bin y Inf en el último. Si no se especifican los intervalos de los bins, hist los calcula utilizando solo los valores finitos del arreglo de entrada.

Tipos de datos: single|double|logical|categorical

nbins — Número de bins

10 (predeterminado) | escalar

Número de bins. La entrada x debe ser numérica, no categórica.

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

xbins — Ubicaciones o categorías de los bins

vector

Ubicaciones o categorías de los bins, especificadas como vector.

Si x es numérico o lógico, xbins debe ser del tipo single o double.

• Si los elementos de xbins son equidistantes, son los centros de los bins.

• Si los elementos de xbins no son equidistantes, se indican con marcadores a lo largo del eje x, pero no son los centros reales de los bins. En cambio, hist calcula los bordes de los bins como los puntos medios entre elementos consecutivos del vector xbins. Para especificar directamente los bordes de los bins, utilice histc.

• xbins solo debe contener valores finitos. El primer y el último bin comprenden los valores mínimo y máximo de x.

Si x es categórico, xbins debe ser un vector categórico o un arreglo de celdas de vectores de caracteres que especifique categorías. hist representa barras solo para esas categorías especificadas por xbins.

ax — Objeto de ejes

objeto de ejes

Objeto de ejes. Use ax para representar el histograma en un eje específico en lugar de los ejes actuales (gca).

Argumentos de salida

counts — Recuento del número de elementos en cada bin

vector fila

Recuento del número de elementos en cada bin, devuelto como vector fila.

centers — Centros o categorías de bins

vector

Centros o categorías de bins, devueltos como vector. Si se utiliza con la sintaxis [counts,centers] = hist(x,xbins), la salida de centers tiene los mismos elementos que la entrada de xbins.

• Si x es numérico o lógico, centers es un vector fila numérico.

• Si x es categórico, centers es un arreglo de celdas de vectores de caracteres.

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• La generación de código no es compatible con la creación de gráficas de barras histogramas. Llame a hist con al menos un argumento de salida.

• El argumento de entrada ax no es compatible.

• Si se utiliza, el argumento nbins debe ser una constante en el tiempo de generación del código.

• Para el argumento de entrada xbins:

  • Debe especificar el vector de entrada como un vector de tamaño fijo o de longitud variable en el tiempo de generación del código. La primera o la segunda dimensión del vector pueden ser de tamaño variable. El resto de dimensiones debe tener un tamaño fijo de 1.

• Los valores del arreglo de entrada x deben ser reales.

• Las orientaciones de los vectores producidos por el código generado pueden no coincidir con las orientaciones de los vectores producidos por MATLAB^®.

• Si x es una matriz de tamaño variable en el tiempo de generación del código, x no puede ser un vector fila en tiempo de ejecución. Para evitar este error, especifique x como un vector fila de tamaño fijo o de longitud variable.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función hist es compatible con entradas de arreglos de GPU con estas notas y limitaciones de uso:

• Esta función acepta arreglos de 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

bar | histc | mode | patch | rose | stairs | histogram | histcounts