matplotlib.pyplot.hist

matplotlib.pyplot.hist(x, bins=None, range=None, density=False, weights=None, cumulative=False, bottom=None, histtype='bar', align='mid', orientation='vertical', rwidth=None, log=False, color=None, label=None, stacked=False, *, data=None, **kwargs)[source]

Вычислите и постройте гистограмму.

Этот метод использует numpy.histogram для разбиения данных в x и подсчёта количества значений в каждом интервале, затем рисует распределение в виде BarContainer или Polygon. Параметры bins, range, density и weights передаются в numpy.histogram.

Если данные уже сгруппированы и подсчитаны, используйте bar или stairs для построения распределения:

counts, bins = np.histogram(x)
plt.stairs(counts, bins)

В качестве альтернативы, постройте предварительно вычисленные интервалы и счётчики, используя hist() рассматривая каждый интервал как отдельную точку с весом, равным его счётчику:

plt.hist(bins[:-1], bins, weights=counts)

Входные данные x могут быть представлен как массив, список наборов данных с, возможно, различной длиной ([x0, x1, ...]), или двумерный массив NumPy, в котором каждая колонка представляет набор данных. Обратите внимание, что представление массива ndarray транспонировано относительно представления списка. Если вход является массивом, то возвращаемое значение — кортеж (n, bins, patches); если вход является последовательностью массивов, то возвращаемое значение — кортеж ([n0, n1, ...], bins, [patches0, patches1, ...]).

Маскированные массивы не поддерживаются.

Параметры:

x(n,) массив или последовательность (n,) массивов

Вводные значения, принимается либо один массив, либо последовательность массивов, которые необязательно имеют одинаковую длину.

binsцелое число или последовательность или строка, по умолчанию: rcParams["hist.bins"] (по умолчанию: 10)

Если bins — целое число, оно определяет количество интервалов равной ширины в диапазоне.

Если bins — последовательность, она определяет границы интервалов, включая левую границу первого интервала и правую границу последнего интервала; в этом случае интервалы могут быть неравномерными. Все интервалы, кроме последнего (правого), являются полуоткрытыми. Другими словами, если bins:

[1, 2, 3, 4]

то первый интервал — [1, 2) (включая 1, но исключая 2), а второй — [2, 3). Последний интервал, однако, [3, 4], который включает 4.

Если bins — строка, она представляет одну из стратегий разбиения, поддерживаемых numpy.histogram_bin_edges: 'auto', 'fd', 'doane', 'scott', 'stone', 'rice', 'sturges' или 'sqrt'.

rangeкортеж или None, по умолчанию: None

Диапазон интервалов: нижняя и верхняя граница. Выбросы ниже и выше диапазона игнорируются. Если не указан, range — (x.min(), x.max()). Range не имеет эффекта, если bins — последовательность.

Если bins — последовательность или указан range, автоматическое масштабирование основано на указанном диапазоне интервалов, а не на диапазоне x.

densitybool, по умолчанию: False

Если True, рисуется и возвращается плотность вероятности: каждый интервал отображает исходное значение счётчика интервала, делённое на общее количество счётчиков * и ширину интервала (density = counts / (sum(counts) * np.diff(bins))) так, что площадь под гистограммой интегрируется до 1 (np.sum(density * np.diff(bins)) == 1).

Если stacked также True, сумма гистограмм нормализуется до 1.

weights(n,) array-like или None, по умолчанию: None

Массив весов, имеющий такую же форму, как x. Каждое значение в x вносит свой соответствующий вес в счётчик интервала (вместо 1). Если density — True, веса нормализуются, так что интеграл плотности в диапазоне остаётся равным 1.

cumulativebool или -1, по умолчанию: False

Если True, вычисляется гистограмма, где каждый интервал даёт количество счётчиков в этом интервале плюс все интервалы для меньших значений. Последний интервал даёт общее количество точек данных.

Если density также True, гистограмма нормализуется так, что последний интервал равен 1.

Если cumulative — число меньше 0 (например, -1), направление накопления меняется. В этом случае, если density также True, гистограмма нормализуется так, что первый интервал равен 1.

bottomarray-like, скаляр или None, по умолчанию: None

Положение нижней границы каждого интервала, т.е. интервалы рисуются от bottom до bottom + hist(x, bins) Если скаляр, нижняя граница каждого интервала сдвигается на одинаковое значение. Если массив, каждый интервал сдвигается независимо, и длина bottom должна совпадать с числом интервалов. Если None, по умолчанию 0.

histtype{'bar', 'barstacked', 'step', 'stepfilled'}, по умолчанию: 'bar'

Тип гистограммы для построения.

'bar' — традиционная гистограмма в виде столбцов. Если задано несколько данных, столбцы располагаются рядом.
'barstacked' — гистограмма в виде столбцов, где несколько данных накладываются друг на друга.
'step' создаёт график линии, который по умолчанию не заполнен.
'stepfilled' создаёт график линии, который по умолчанию заполнен.

align{'left', 'mid', 'right'}, по умолчанию: 'mid'

Горизонтальное выравнивание столбцов гистограммы.

'left': столбцы центрируются на левых границах интервалов.
'mid': столбцы центрируются между границами интервалов.
'right': столбцы центрируются на правых границах интервалов.

orientation{'vertical', 'horizontal'}, по умолчанию: 'vertical'

Если 'horizontal', будет использоваться barh для гистограмм в виде столбцов, и параметр bottom будет представлять левые границы.

rwidthfloat или None, по умолчанию: None

Относительная ширина столбцов как доля ширины интервала. Если None, автоматически вычисляется ширина.

Игнорируется, если histtype — 'step' или 'stepfilled'.

logbool, по умолчанию: False

Если True, ось гистограммы будет установлена в логарифмический масштаб.

colorцвет или массив цветов или None, по умолчанию: None

Цвет или последовательность цветов, по одному на набор данных. По умолчанию (None) используется стандартная последовательность цветов линий.

labelстрока или None, по умолчанию: None

Строка или последовательность строк для соответствия нескольким наборам данных. Гистограммы в виде столбцов дают несколько объектов столбцов на набор данных, но метка применяется только к первому объекту, чтобы legend работало как ожидается.

stackedbool, по умолчанию: False

Если True, несколько данных накладываются друг на друга. Если False несколько данных располагаются бок о бок, если histtype — 'bar', или друг на друге, если histtype — 'step'

Возвращаемое значение:

nмассив или список массивов: Значения интервалов гистограммы. См. density и weights для описания возможных значений. Если вход x — массив, то это массив длиной nbins. Если вход — последовательность массивов [data1, data2, ...], то это список массивов со значениями гистограмм для каждого из массивов в том же порядке. Тип данных массива n (или его элементов массивов) всегда будет float, даже если не используются взвешивание или нормализация.
binsмассив: Границы интервалов. Длина nbins + 1 (nbins левых границ и правая граница последнего интервала). Всегда один массив, даже при передаче нескольких наборов данных.
patchesBarContainer или список одного Polygon или список таких объектов: Контейнер отдельных объектов-графических элементов, используемых для создания гистограммы, или список таких контейнеров, если имеется несколько наборов входных данных.

Другие параметры:

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения):

x, weights

**kwargs

Свойства Patch

См. также

hist2d: 2D гистограмма с прямоугольными ячейками
hexbin: 2D гистограмма с шестиугольными ячейками
stairs: Построение предварительно вычисленной гистограммы
bar: Построение предварительно вычисленной гистограммы

Примечания

Для большого числа ячеек (>1000) построение можно существенно ускорить, используя stairs для построения предварительно вычисленной гистограммы (plt.stairs(*np.histogram(data))), или установив histtype в 'step' или 'stepfilled' вместо 'bar' или 'barstacked'.

Примеры использования `matplotlib.pyplot.hist`

Гистограммы

Построение кумулятивных распределений

Некоторые функции гистограммы (hist)

Демонстрация различных настроек histtype функции гистограммы

Функция гистограммы (hist) с несколькими наборами данных

Текст и mathtext с использованием pyplot

Анимированная гистограмма

SVG гистограмма

Руководство по pyplot

Руководство по изображениям

matplotlib.pyplot.hist

Примечания

Примеры использования matplotlib.pyplot.hist

Примеры использования `matplotlib.pyplot.hist`