matplotlib.axes.Axes.hist

Axes.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,) массив или последовательность (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,) массив-подобный объект или None, по умолчанию: None

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

Этот параметр можно использовать для построения гистограммы данных, которые уже сгруппированы, например, с помощью numpy.histogram (обращаясь к каждому бину как к одной точке с весом, равным его счёту).

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

(или вы можете альтернативно использовать bar()).

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

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

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

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

bottomмассив-подобный объект, скаляр или 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 или список таких объектов: Контейнер отдельных элементов, используемых для создания гистограммы, или список таких контейнеров, если передано несколько наборов входных данных.

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