matplotlib.axes.Axes.hist
-
Axes.hist(self, 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]
то первый интервал —
[2, 3)(включая 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 - 2D гистограммы
Примечания
Примечание
Помимо вышеописанных аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:
- Все аргументы с следующими именами: 'weights', 'x'.
Объекты, переданные как data, должны поддерживать доступ по элементам (
data[<arg>]) и проверку на членство (<arg> in data). -
Примеры использования matplotlib.axes.Axes.hist
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.2.2/api/_as_gen/matplotlib.axes.Axes.hist.html