matplotlib.pyplot.hist

matplotlib.pyplot.hist(x, bins=None, range=None, density=None, weights=None, cumulative=False, bottom=None, histtype='bar', align='mid', orientation='vertical', rwidth=None, log=False, color=None, label=None, stacked=False, normed=None, *, data=None, **kwargs) [source]

Построение гистограммы.

Вычисление и построение гистограммы для x. Возвращаемое значение — кортеж (n, bins, patches) или ([n0, n1, ...], bins, [patches0, patches1,...]) если входные данные содержат несколько наборов данных.

Несколько наборов данных могут быть предоставлены через x как список наборов данных, возможно, различной длины ([x0, x1, ...]), или как двумерный массив NumPy, где каждый столбец представляет набор данных. Обратите внимание, что форма массива NumPy транспонирована относительно формы списка.

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

Параметры:	x : (n,) array or sequence of (n,) arrays Входные значения, принимающие либо один массив, либо последовательность массивов, длина которых необязательно должна быть одинаковой. bins : int or sequence or str, optional Если указано целое число, bins + 1 рассчитываются и возвращаются граничные значения интервалов, согласуясь с numpy.histogram. Если bins является последовательностью, возвращаются граничные значения интервалов, включая левую границу первого интервала и правую границу последнего интервала. В этом случае bins возвращается без изменений. Все интервалы, кроме последнего (правого), полуоткрытые. Другими словами, если bins: [1, 2, 3, 4] то первый интервал — [1, 2) (включая 1, но не включая 2), а второй — [2, 3). Последний интервал, однако, — [3, 4], который включает 4. Поддерживаются интервалы с неравномерным шагом, если bins — последовательность. С NumPy 1.11 или новее вы можете альтернативно указать строку, описывающую стратегию разбиения, например, 'auto', 'sturges', 'fd', 'doane', 'scott', 'rice', 'sturges' или 'sqrt', см. numpy.histogram. По умолчанию значение взято из rcParams["hist.bins"]. range : tuple or None, optional Нижний и верхний пределы интервалов. Значения за пределами этого диапазона игнорируются. Если не указано, range — (x.min(), x.max()). Диапазон не оказывает влияния, если bins — последовательность. Если bins — последовательность или указан range, автоматическое масштабирование выполняется на основе указанного диапазона интервалов, а не диапазона x. По умолчанию None density : bool, optional Если True, первый элемент возвращаемого кортежа будет представлять подсчеты, нормированные для получения плотности вероятности, т.е., площадь (или интеграл) под гистограммой будет суммироваться до 1. Это достигается путем деления подсчета на число наблюдений, умноженное на ширину интервала, а не деления на общее число наблюдений. Если также установлено stacked, сумма гистограмм будет нормирована до 1. По умолчанию None для normed и density. Если установлено любое из них, то будет использовано это значение. Если ни одно из них не установлено, значения будут рассматриваться как False. Если установлены оба density и normed, вызывается ошибка. weights : (n, ) array_like or None, optional Массив весов, имеющий такую же форму, как x. Каждое значение в x вносит свой ассоциированный вес в подсчет интервала (вместо 1). Если normed или density True, веса нормируются, так что интеграл плотности в диапазоне остается равным 1. По умолчанию None cumulative : bool, optional Если True, вычисляется гистограмма, где каждый интервал показывает подсчеты в этом интервале плюс все интервалы для меньших значений. Последний интервал содержит общее количество точек данных. Если normed или density также True, гистограмма нормируется таким образом, что последний интервал равен 1. Если cumulative принимает значение меньше 0 (например, -1), направление накопления изменяется. В этом случае, если normed и/или density также True, гистограмма нормируется таким образом, что первый интервал равен 1. По умолчанию False bottom : array_like, scalar, or None Положение нижней базовой линии каждого интервала. Если скаляр, базовая линия каждого интервала смещается на одно и то же значение. Если массив, каждый интервал смещается независимо, и длина bottom должна соответствовать количеству интервалов. Если None, по умолчанию 0. По умолчанию None 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 будет обозначать левые границы. rwidth : scalar or None, optional Относительная ширина столбцов как доля ширины интервала. Если None, ширина вычисляется автоматически. Игнорируется, если histtype — 'step' или 'stepfilled'. По умолчанию None log : bool, optional Если True, ось гистограммы будет построена в логарифмическом масштабе. Если log True и x — одномерный массив, пустые интервалы будут отфильтрованы, и будут возвращены только ненулевые (n, bins, patches). По умолчанию False color : color or array_like of colors or None, optional Спецификация цвета или последовательность спецификаций цвета, по одной для каждого набора данных. По умолчанию (None) используется стандартная последовательность цветов для линий. По умолчанию None label : str or None, optional Строка или последовательность строк для соответствия нескольким наборам данных. Гистограммы в виде столбцов возвращают несколько объектов patches на набор данных, но только первый получает метку, чтобы команда легенды работала как ожидается. По умолчанию None stacked : bool, optional Если True, несколько наборов данных накладываются друг на друга. Если False несколько наборов данных располагаются рядом, если histtype — 'bar', или накладываются друг на друга, если histtype — 'step' По умолчанию False normed : bool, optional Устарело; используйте вместо этого ключевой аргумент density.
Возвращаемое значение:	n : array or list of arrays Значения интервалов гистограммы. См. normed или density и weights для описания возможной семантики. Если вход x — массив, то это массив длины nbins. Если вход — последовательность массивов [data1, data2,..], то это список массивов со значениями гистограмм для каждого из массивов в том же порядке. bins : array Границы интервалов. Длина nbins + 1 (nbins левых границ и правая граница последнего интервала). Всегда один массив, даже когда передаются несколько наборов данных. patches : list or list of lists Скрытый список отдельных объектов patches, используемых для создания гистограммы, или список таких списков, если передано несколько наборов входных данных.
Другие параметры:	**kwargs : Patch properties

См. также

hist2d

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

Примечания

Примечание

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

• Все аргументы со следующими именами: 'weights', 'x'.

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

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

Демонстрация использования осей

Текст в Pyplot

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

Учебник по Pyplot

Учебник по изображениям