matplotlib.axes.Axes.hist

Axes.hist(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,...]) если входные данные содержат несколько наборов данных.

Несколько наборов данных могут быть заданы через x как список наборов данных потенциально различной длины ([x0, x1, ...]), или как 2-мерный массив 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', 'sturges' или '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. По умолчанию для normed и density используется значение None. Если значение задано, оно будет использовано. Если ни одно не задано, то значения будут интерпретированы как False. Если заданы и density и normed, то генерируется ошибка. weights : (n, ) array_like or None, optional Массив весов, имеющий ту же форму, что и x. Каждое значение в x вносит свой вес в подсчет интервала (вместо 1). Если normed или density True, веса нормируются так, чтобы интеграл плотности по заданному диапазону оставался равным 1. По умолчанию — None 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 Строка или последовательность строк для сопоставления нескольких наборов данных. Гистограммы в виде столбцов содержат несколько областей для каждого набора данных, но метку получает только первая, чтобы команда легенды работала как ожидается. По умолчанию — None stacked : bool, optional Если True, несколько наборов данных накладываются друг на друга. Если False несколько наборов данных располагаются рядом, если histtype — 'bar', или друг над другом, если histtype — 'step'. По умолчанию — False normed : bool, optional Устарело; используйте вместо этого параметр density.
Возвращает:	n : array or list of arrays Значения интервалов гистограммы. См. normed или density и weights для описания возможных семантик. Если вход x — массив, то это массив длины nbins. Если вход — последовательность массивов [data1, data2,..], то это список массивов со значениями гистограмм для каждого массива в том же порядке. 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) с несколькими дополнительными функциями

Fig Axes Labels Simple

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