matplotlib.axes.Axes.hist

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

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

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

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

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

Параметры:	x : (n,) array or sequence of (n,) arrays Значения входных данных, принимаются как один массив или последовательность массивов, не обязательно одинаковой длины. bins : int or sequence or str, optional Если указано целое число, bins + 1 вычисляются и возвращаются границы интервалов, соответствующие numpy.histogram. Если bins является последовательностью, то задаются границы интервалов, включая левую границу первого интервала и правую границу последнего интервала. В этом случае bins возвращается без изменений. Все интервалы (кроме последнего), за исключением последнего (правого), являются полуоткрытыми. Другими словами, если bins: [1, 2, 3, 4] то первый интервал — это [1, 2) (включая 1, но не включая 2), а второй [2, 3). Последний интервал, однако, — это [3, 4], который включает 4. Поддерживаются интервалы с неравномерным шагом, если bins является последовательностью. С NumPy 1.11 или новее вы также можете указать строку, описывающую стратегию разбиения, например, 'auto', 'sturges', 'fd', 'doane', 'scott', 'rice' или 'sqrt', см. numpy.histogram. По умолчанию используется значение из rcParams["hist.bins"]. range : tuple or None, optional Нижний и верхний пределы интервалов. Значения вне диапазона игнорируются. Если не указаны, range равен (x.min(), x.max()). Параметр range не имеет эффекта, если bins является последовательностью. Если bins — последовательность или range указан, автоматическое масштабирование основано на заданном диапазоне интервалов, а не на диапазоне x. По умолчанию None density : bool, optional Если True, первый элемент возвращаемого кортежа будет представлять отсчёты, нормированные для получения плотности вероятности, т.е. площадь (или интеграл) под гистограммой будет равна 1. Это достигается путём деления отсчёта на число наблюдений умноженное на ширину интервала, а не на общее число наблюдений. Если также установлен stacked, сумма гистограмм нормализуется до 1. По умолчанию None для обоих normed и density. Если какой-либо из них установлен, будет использовано это значение. Если ни один из них не установлен, значения будут обработаны как False. Если оба density и normed установлены, генерируется ошибка. 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()). cumulative : bool, optional Если True, вычисляется гистограмма, где каждый интервал содержит отсчёты в этом интервале плюс все интервалы для меньших значений. Последний интервал содержит общее число точек данных. Если normed или density также True, гистограмма нормализуется таким образом, что последний интервал равен 1. Если cumulative принимает значение меньше 0 (например, -1), направление накопления изменяется. В этом случае, если normed и/или density также True, гистограмма нормализуется так, что первый интервал равен 1. По умолчанию False bottom : array_like, scalar, or None Положение нижней базовой линии каждого интервала. Если скалярное значение, нижняя граница каждого интервала смещается на одинаковое значение. Если массив, каждый интервал смещается независимо, и длина bottom должна соответствовать количеству интервалов. Если None, по умолчанию 0. По умолчанию None 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 будет обозначать левые границы. rwidth : scalar or None, optional Относительная ширина столбцов как доля ширины интервала. Если None, ширина вычисляется автоматически. Игнорируется, если histtype равен 'step' или 'stepfilled'. По умолчанию None log : bool, optional Если True, ось гистограммы будет установлена в логарифмический масштаб. Если log True и x — одномерный массив, пустые интервалы будут отфильтрованы, и будут возвращены только непустые (n, bins, patches). По умолчанию False color : color or array_like of colors or None, optional Спецификация цвета или последовательность спецификаций цвета, по одной на набор данных. По умолчанию (None) используется стандартная последовательность цветов линий. По умолчанию None label : str or None, optional Строка или последовательность строк для сопоставления с несколькими наборами данных. Гистограммы с столбцами дают несколько объектов-столбцов на набор данных, но только первый получает метку, чтобы команда legend работала как ожидается. По умолчанию None stacked : bool, optional Если True, несколько наборов данных накладываются друг на друга. Если False, несколько наборов данных располагаются бок о бок, если histtype равен 'bar', или друг на друге, если histtype равен 'step'. По умолчанию False normed : bool, optional Устарело; используйте параметр density вместо него.
Возвращаемое значение:	n : array or list of arrays Значения интервалов гистограммы. См. density и weights для описания возможных семантик. Если входной параметр x является массивом, то это массив длиной nbins. Если входной параметр — последовательность массивов [data1, data2,..], то это список массивов со значениями гистограмм для каждого из массивов в том же порядке. Тип данных массива n (или его массивов-элементов) всегда будет float, даже если не используется взвешивание или нормализация. bins : array Границы интервалов. Длина nbins + 1 (nbins левых границ и правая граница последнего интервала). Всегда один массив, даже когда передаётся несколько наборов данных. patches : list or list of lists Скрытый список отдельных участков, используемых для создания гистограммы, или список таких списков, если передаётся несколько наборов входных данных.
Другие параметры:	**kwargs : Patch properties

См. также

hist2d

2D гистограммы

Примечания

Примечание

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

• Все аргументы с именами: 'weights', 'x'.

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

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

Демонстрация функции гистограммы (hist) с несколькими дополнительными возможностями

Простые метки осей

Построение гистограмм с использованием прямоугольников и коллекций PolyCollections