Main Content

La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

hist

Gráfica de histograma (no recomendada; utilice histogram)

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.

Descripción

ejemplo

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.

ejemplo

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.

ejemplo

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

Ejemplos

contraer todo

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

Figure contains an axes object. The axes object contains an object of type patch. This object represents 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.

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

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

Figure contains an axes object. The axes object contains 3 objects of type patch. These objects represent x(:,1), x(:,2), x(:,3).

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.

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

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

Figure contains an axes object. The axes object contains an object of type patch. This object represents x.

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)

Figure contains an axes object. The axes object contains an object of type bar.

Genere 1000 números aleatorios y cree un histograma.

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

Figure contains an axes object. The axes object contains an object of type patch. This object represents 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';

Figure contains an axes object. The axes object contains an object of type patch. This object represents data.

Argumentos de entrada

contraer todo

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

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

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.

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

Argumentos de salida

contraer todo

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

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

Historial de versiones

Introducido antes de R2006a

Consulte también

| | | | | | |