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, ...]) или в виде двумерного массива NumPy, где каждый столбец представляет набор данных. Обратите внимание, что форма массива NumPy транспонирована относительно формы списка.

Маскированные массивы не поддерживаются.

Параметры bins, range, weights и density ведут себя так же, как и в numpy.histogram.

Параметры:	x(n,) array or sequence of (n,) arrays Значения входных данных, принимающие либо один массив, либо последовательность массивов, длина которых не обязана быть одинаковой. binsint or sequence or str, default: rcParams["hist.bins"] (default: 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'. rangetuple or None, default: None Нижний и верхний пределы интервалов. Значения вне указанного диапазона игнорируются. Если не указано, range — (x.min(), x.max()). Параметр range не имеет эффекта, если bins — последовательность. Если bins — последовательность или задан range, автоматическое масштабирование выполняется на основе заданного диапазона интервалов вместо диапазона значений x. densitybool, default: False Если True, вычисляется и возвращается плотность вероятности: каждый интервал будет отображать количество элементов в интервале, делённое на общее количество элементов и ширину интервала (density = counts / (sum(counts) * np.diff(bins))), так что площадь под гистограммой интегрируется в 1 (np.sum(density * np.diff(bins)) == 1). Если также задан stacked, то сумма гистограмм нормализуется до 1. weights(n,) array-like or None, default: None Массив весов, имеющий такую же форму, как и x. Каждое значение в x вносит свой вес в счёт интервала (вместо 1). Если density — True, веса нормализуются таким образом, что интеграл плотности по диапазону остаётся равным 1. Этот параметр можно использовать для построения гистограммы данных, которые уже сгруппированы, например, с помощью numpy.histogram (обрабатывая каждый интервал как отдельную точку с весом, равным его количеству). counts, bins = np.histogram(data) plt.hist(bins[:-1], bins, weights=counts) (или вы можете альтернативно использовать bar()). cumulativebool or -1, default: False Если 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'}, default: 'bar' Тип гистограммы для отображения. 'bar' — традиционная гистограмма в виде столбцов. Если указано несколько наборов данных, столбцы расположены рядом. 'barstacked' — гистограмма в виде столбцов, где несколько наборов данных накладываются друг на друга. 'step' генерирует линию, которая по умолчанию не залита. 'stepfilled' генерирует линию, которая по умолчанию залита. align{'left', 'mid', 'right'}, default: 'mid' Горизонтальное выравнивание столбцов гистограммы. 'left': столбцы центрированы по левым границам интервалов. 'mid': столбцы центрированы между границами интервалов. 'right': столбцы центрированы по правым границам интервалов. orientation{'vertical', 'horizontal'}, default: 'vertical' Если 'horizontal', для гистограмм в виде столбцов будет использоваться barh, и параметр bottom будет левой границей. rwidthfloat or None, default: None Относительная ширина столбцов как доля ширины интервала. Если None, ширина вычисляется автоматически. Игнорируется, если histtype — 'step' или 'stepfilled'. logbool, default: False Если True, ось гистограммы будет задана в логарифмическом масштабе. Если log — True и x — одномерный массив, пустые интервалы будут отфильтрованы, и возвращены только ненулевые (n, bins, patches). colorcolor or array-like of colors or None, default: None Цвет или последовательность цветов, по одному на набор данных. По умолчанию (None) используется стандартная последовательность цветов линий. labelstr or None, default: None Строка или последовательность строк для сопоставления с несколькими наборами данных. Гистограммы в виде столбцов отображают несколько объектов для каждого набора данных, но только первый получает метку, так что legend будет работать как ожидается. stackedbool, default: False Если True, несколько наборов данных накладываются друг на друга. Если False несколько наборов данных располагаются бок о бок, если histtype — 'bar', или друг над другом, если histtype — 'step'.
Возвращаемые значения:	narray or list of arrays Значения интервалов гистограммы. См. density и weights для описания возможных значений. Если вход x — массив, это массив длины nbins. Если вход — последовательность массивов [data1, data2, ...], это список массивов со значениями гистограмм для каждого массива в том же порядке. Тип данных массива n (или его элементов массивов) всегда будет float, даже если не используется взвешивание или нормализация. binsarray Границы интервалов. Длина nbins + 1 (nbins левых границ и правая граница последнего интервала). Всегда один массив, даже если переданы несколько наборов данных. patchesBarContainer or list of a single Polygon or list of such objects Контейнер отдельных графических элементов, используемых для создания гистограммы, или список таких контейнеров, если существует несколько наборов входных данных.
Другие параметры:	**kwargs Свойства Patch

См. также

hist2d

Двумерные гистограммы

Примечания

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

Примечание

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

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

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

Текст Pyplot

SVG Гистограмма

Руководство по pyplot

Примеры графиков в Matplotlib

Руководство по изображениям