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]

Построение гистограммы.

Вычисление и построение гистограммы для x. Возвращаемое значение — кортеж (n, bins, patches) или ([n0, n1, ...], bins, [patches0, patches1,...]) если входные данные содержат несколько наборов данных. См. документацию параметра weights для построения гистограммы уже сгруппированных данных.

Несколько наборов данных могут быть предоставлены через x как список наборов данных, возможно, разной длины ([x0, x1, ...]), или как двумерный массив NumPy, в котором каждая колонка представляет набор данных. Обратите внимание, что форма массива NumPy транспонирована относительно формы списка.

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

Параметры bins, range, weights и density работают так же, как и в numpy.histogram.

Параметры:	x(n,) array or sequence of (n,) arrays Входные значения, принимающие либо один массив, либо последовательность массивов, длина которых не обязательно должна быть одинаковой. binsint or sequence or str, optional Если 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'. По умолчанию rcParams["hist.bins"] (по умолчанию: 10). rangetuple or None, optional Нижний и верхний пределы интервалов. Нижние и верхние выбросы игнорируются. Если не задано, range — (x.min(), x.max()). Параметр range не имеет эффекта, если bins — последовательность. Если bins — последовательность или задан range, автоматическое масштабирование основано на заданном диапазоне интервалов вместо диапазона x. Значение по умолчанию — None densitybool, optional Если True, первый элемент возвращаемого кортежа будет представлять счёт, нормированный для образования плотности вероятности, т. е. площадь (или интеграл) под гистограммой будет суммироваться до 1. Это достигается путём деления счётчика на число наблюдений умноженное на ширину интервала, а не на общее число наблюдений. Если stacked также True, сумма гистограмм нормализуется до 1. Значение по умолчанию — False. weights(n, ) array-like or None, optional Массив весов, с той же формой, что и x. Каждое значение в x вносит свой связанный вес в счёт интервалов (вместо 1). Если normed или density True, веса нормализуются, так что интеграл плотности в диапазоне остаётся равным 1. Значение по умолчанию — None. Этот параметр может использоваться для построения гистограммы данных, которые уже были сгруппированы, например, с помощью np.histogram (путем обработки каждого интервала как одной точки с весом, равным его счету). counts, bins = np.histogram(data) plt.hist(bins[:-1], bins, weights=counts) (или вы можете альтернативно использовать bar()). cumulativebool or -1, optional Если True, вычисляется гистограмма, в которой каждый интервал даёт счёт в этом интервале плюс все интервалы для меньших значений. Последний интервал даёт общее число точек данных. Если density также True, гистограмма нормализуется так, что последний интервал равен 1. Если cumulative — число меньше 0 (например, -1), направление накопления меняется. В этом случае, если density также True, гистограмма нормализуется так, что первый интервал равен 1. bottomarray-like, scalar, or None, default: None Позиция нижней границы каждого интервала, т.е. интервалы строятся от bottom до bottom + hist(x, bins). Если скаляр, нижняя граница каждого интервала сдвигается на то же значение. Если массив, каждый интервал сдвигается независимо, и длина bottom должна соответствовать числу интервалов. Если None, значение по умолчанию — 0. histtype{'bar', 'barstacked', 'step', 'stepfilled'}, optional Тип гистограммы. 'bar' — традиционная гистограмма в виде столбцов. Если задано несколько наборов данных, столбцы располагаются рядом. 'barstacked' — гистограмма в виде столбцов, где несколько наборов данных накладываются друг на друга. 'step' — построение линии, по умолчанию не залитой. 'stepfilled' — построение линии, по умолчанию залитой. Значение по умолчанию — 'bar' align{'left', 'mid', 'right'}, optional Управление расположением столбцов на гистограмме. 'left': столбцы центрированы по левой границе интервалов. 'mid': столбцы центрированы между границами интервалов. 'right': столбцы центрированы по правой границе интервалов. Значение по умолчанию — 'mid' orientation{'horizontal', 'vertical'}, optional Если 'horizontal', для гистограмм в виде столбцов будет использована barh, а параметр bottom будет обозначать левые границы. rwidthscalar or None, optional Относительная ширина столбцов как доля ширины интервала. Если None, ширина автоматически рассчитывается. Игнорируется, если histtype 'step' или 'stepfilled'. Значение по умолчанию — None logbool, optional Если True, ось гистограммы будет установлена в логарифмическом масштабе. Если log True и x — одномерный массив, пустые интервалы будут отфильтрованы, и будут возвращены только ненулевые (n, bins, patches). Значение по умолчанию — False colorcolor or array-like of colors or None, optional Цвет или последовательность цветов, по одному на каждый набор данных. По умолчанию (None) используется стандартная последовательность цветов линий. Значение по умолчанию — None labelstr or None, optional Строка или последовательность строк для сопоставления с несколькими наборами данных. Гистограммы в виде столбцов дают несколько областей для каждого набора данных, но метку получает только первая, чтобы команда legend работала как ожидается. Значение по умолчанию — None stackedbool, optional Если True, несколько наборов данных накладываются друг на друга. Если False, несколько наборов данных располагаются бок о бок, если histtype — 'bar', или друг над другом, если histtype — 'step'. Значение по умолчанию — False
Возвращаемые значения:	narray or list of arrays Значения интервалов гистограммы. См. density и weights для описания возможных значений. Если вход x — массив, то это массив длиной nbins. Если вход — последовательность массивов [data1, data2, ...], то это список массивов со значениями гистограмм для каждого из массивов в том же порядке. Тип данных массива n (или его элементов массивов) всегда будет float, даже если не используются взвешивание или нормализация. binsarray Границы интервалов. Длина nbins + 1 (nbins левых границ и правая граница последнего интервала). Всегда один массив, даже когда передаются несколько наборов данных. patcheslist or list of lists Список отдельных областей, используемых для создания гистограммы, или список таких списков, если задано несколько наборов входных данных.
Другие параметры:	**kwargsPatch properties

См. также

hist2d

Двумерные гистограммы

Примечания

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать ключевое слово data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все аргументы со следующими именами: 'weights', 'x'.

Объекты, передаваемые как data, должны поддерживать доступ по элементам (data[<arg>]) и проверку на принадлежность (<arg> in data).

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

Текст Pyplot

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

Урок Pyplot

Примеры графиков в Matplotlib

Урок по изображениям