тсс

График гистограммы (не рекомендуемый; используйте histogram),

hist не рекомендуется. Используйте histogram вместо этого.

Для получения дополнительной информации, включая предложения при обновлении кода, см. Замену нежелательных экземпляров тсс и histc.

Синтаксис

hist(x)
hist(x,nbins)
hist(x,xbins)
hist(ax,___)
counts = hist(___)
[counts,centers] = hist(___)

Описание

пример

hist(x) создает столбчатую диаграмму гистограммы элементов в векторном x. Элементы в x сортируются в 10 равномерно распределенных интервалов вдоль оси X между минимальными и максимальными значениями x. hist отображает интервалы как прямоугольники, такие, что высота каждого прямоугольника указывает на число элементов в интервале.

Если вход является многостолбцовым массивом, hist создает гистограммы для каждого столбца x и накладывает их на один график.

Если вход имеет тип данных categorical, каждый интервал является категорией x.

пример

hist(x,nbins) виды x в количество интервалов заданы скалярным nbins.

пример

hist(x,xbins) виды x в интервалы с интервалами или категориями определяются векторным xbins.

  • Если xbins является вектором равномерно расположенных с интервалами значений, то hist использует значения в качестве центров интервала.

  • Если xbins является вектором неравномерно расположенных с интервалами значений, то hist использует средние точки между последовательными значениями как ребра интервала.

  • Если x имеет тип данных categorical, то xbins должен быть категориальным вектором или массивом ячеек из символьных векторов, который задает категории. hist строит панели только для тех категорий.

Длина векторного xbins равна количеству интервалов.

пример

hist(ax,___) графики в оси, заданные ax вместо в текущую систему координат (gca). Опция ax может предшествовать любой комбинации входных аргументов в предыдущих синтаксисах.

counts = hist(___) возвращает вектор - строку, counts, содержа число элементов в каждом интервале.

пример

[counts,centers] = hist(___) возвращает дополнительный вектор - строку, centers, указывая на местоположение каждого центра интервала на оси X.

Примеры

свернуть все

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 сортирует значения в x среди 10 равномерно распределенных интервалов между минимальными и максимальными значениями в векторе, которые являются 0 и 10 в этом примере.

Сгенерируйте три столбца 1 000 случайных чисел и постройте наложенную гистограмму трех столбцов.

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

Значения в x сортируются среди 10 равномерно распределенных интервалов между минимальными и максимальными значениями. виды hist и интервалы столбцы x отдельно и строят график каждого столбца с различным цветом.

Постройте гистограмму 1 000 случайных чисел, отсортированных в 50 равномерно распределенных интервалов.

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

Постройте три гистограммы тех же данных с помощью различных интервалов интервала:

  • В верхнем подграфике задайте центры интервала с помощью вектора равномерно расположенных с интервалами значений, которые охватывают значения в x.

  • В среднем подграфике задайте центры интервала с помощью вектора равномерно расположенных с интервалами значений, которые не охватывают значения в x. Первые и последние интервалы расширяют, чтобы покрыть минимальные и максимальные значения в x.

  • В более низком подграфике задайте интервалы интервала с помощью вектора неравномерно расположенных с интервалами значений. Функция hist использует средние точки между последовательными значениями как ребра интервала и указывает на заданные значения маркерами вдоль оси X.

x = randn(1000,1); 
subplot(3,1,1)
xbins1 = -4:4;
hist(x,xbins1)   

subplot(3,1,2)
xbins2 = -2:2;
hist(x,xbins2)   

subplot(3,1,3)
xbins3 = [-4 -2.5 0 0.5 1 3];
hist(x,xbins3)

Создайте фигуру с двумя подграфиками. В верхнем подграфике постройте гистограмму 1 000 случайных чисел, отсортированных в 50 равномерно распределенных интервалов. В более низком подграфике постройте гистограмму тех же данных и используйте интервалы с центрами в-3, 0, и 3.

x = randn(1000,1);
ax1 = subplot(2,1,1); 
hist(ax1,x,50)

ax2 = subplot(2,1,2);
xbins = [-3 0 3];
hist(ax2,x,xbins)

Сгенерируйте 1 000 случайных чисел. Рассчитайте, сколько чисел находится в каждом из 10 равномерно распределенных интервалов. Возвратите количества интервала и центры интервала.

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

Используйте bar, чтобы построить гистограмму.

bar(centers,counts)

Сгенерируйте 1 000 случайных чисел и создайте гистограмму.

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

Получите указатель на объект закрашенной фигуры, который создает график гистограммы.

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

Выберите цвет поверхности панелей, построенных к значению триплета RGB [0 0.5 0.5]. Установите цвет обводки на белый.

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

Входные параметры

свернуть все

Входной вектор или матрица.

  • Если x является вектором, то hist создает одну гистограмму.

  • Если x является матрицей, то hist создает отдельную гистограмму для каждого столбца и строит гистограммы с помощью различных цветов.

Если входной массив содержит NaN s или неопределенные категориальные значения, hist не включает эти значения в количества интервала.

Если входной массив содержит бесконечные значения -Inf или Inf, то виды hist -Inf в первый интервал и Inf в последний интервал. Если вы не задаете интервалы интервала, то hist вычисляет интервалы интервала с помощью только конечные значения во входном массиве.

Типы данных: single|double|logical|categorical

Количество интервалов. Введите x, должно быть числовым, не категориальным.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Местоположения интервала или категории, заданные как вектор.

Если x является числовым или логическим, то xbins должен иметь тип single или double.

  • Если элементы в xbins равномерно распределены, то эти элементы являются центрами интервала.

  • Если элементы в xbins не равномерно распределены, то эти элементы обозначаются маркерами вдоль оси X, но не являются фактическими центрами интервала. Вместо этого hist вычисляет ребра интервала как средние точки между последовательными элементами в векторном xbins. Чтобы задать ребра интервала непосредственно, используйте histc.

  • xbins должен содержать только конечные значения. Первые и последние интервалы расширяют, чтобы покрыть минимальные и максимальные значения в x.

Если x является категориальным, то xbins должен быть категориальным вектором или массивом ячеек из символьных векторов, который задает категории. hist строит панели только для тех категорий, заданных xbins.

Объект осей. Используйте ax, чтобы построить гистограмму в определенные оси вместо текущей системы координат (gca).

Выходные аргументы

свернуть все

Количества числа элементов в каждом интервале, возвращенном как вектор - строка.

Центры интервала или категории, возвращенные как вектор. Если используется с синтаксисом [counts,centers] = hist(x,xbins), то centers вывод имеет те же элементы как вход xbins.

  • Если x является числовым или логическим, то centers является числовым вектором - строкой.

  • Если x является категориальным, то centers является массивом ячеек из символьных векторов.

Расширенные возможности

Смотрите также

| | | | | | |

Представлено до R2006a