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, то сумма гистограмм будет нормализована к 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 левых границ и правая граница последнего интервала). Всегда один массив, даже когда передаётся несколько наборов данных. patches`BarContainer` или список одного `Polygon` или список таких объектов Контейнер отдельных элементов графика, используемых для создания гистограммы, или список таких контейнеров, если передано несколько наборов данных.
Другие параметры:	**kwargs `Patch` свойства

См. также

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

Примечания

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

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать ключевое слово data. Если такое data предоставлено, следующие аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не приводит к исключению): x, weights.

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