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, ...]) или как 2D массив 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 будет обозначать левые границы.

rwidthчисло или 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 или список таких объектов

Контейнер отдельных графических объектов, используемых для создания гистограммы, или список таких контейнеров, если передано несколько наборов входных данных.

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

dataиндексируемый объект, необязательно

Если задан, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение):

x, weights

**kwargs

Patch свойства

См. также

hist2d

2D гистограмма с прямоугольными интервалами

hexbin

2D гистограмма с шестиугольными интервалами

Примечания

Для большого количества интервалов (>1000), 'step' и 'stepfilled' могут быть значительно быстрее, чем 'bar' и 'barstacked'.

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