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, hold=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 : integer or sequence or 'auto', 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'. По умолчанию берется из параметра rc hist.bins. range : tuple or None, optional Нижняя и верхняя границы интервалов. Значения вне этого диапазона игнорируются. Если не указано, range равен (x.min(), x.max()). range не имеет эффекта, если bins является последовательностью. Если bins является последовательностью или задан range, автоматическое масштабирование основано на указанном диапазоне интервалов вместо диапазона x. По умолчанию None density : boolean, optional Если True, первый элемент возвращаемого кортежа будет представлять частоты, нормированные для получения плотности вероятности, т. е. площадь (или интеграл) под гистограммой будет равна 1. Это достигается путем деления подсчета на количество наблюдений, умноженное на ширину интервала, а не на общее количество наблюдений. Если также установлен stacked, сумма гистограмм нормируется до 1. По умолчанию None для обоих normed и density. Если один из них установлен, будет использоваться это значение. Если ни один из них не установлен, аргументы будут интерпретированы как False. Если оба density и normed установлены, возникает ошибка. weights : (n, ) array_like or None, optional Массив весов, с такими же размерами, как x. Каждое значение в x вносит свой связанный вес в подсчет интервала (вместо 1). Если normed или density установлены, веса нормируются, так что интеграл плотности по диапазону остается равным 1. По умолчанию None cumulative : boolean, optional Если True, то вычисляется гистограмма, где каждый интервал содержит подсчеты в этом интервале плюс все интервалы с меньшими значениями. Последний интервал содержит общее количество точек данных. Если normed или density также установлены, гистограмма нормируется таким образом, что последний интервал равен 1. Если cumulative меньше 0 (например, -1), направление накопления изменяется. В этом случае, если normed и/или density также установлены, гистограмма нормируется таким образом, что первый интервал равен 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 : boolean, optional Если True, ось гистограммы будет построена в логарифмическом масштабе. Если log равен True и x является одномерным массивом, пустые интервалы будут отфильтрованы, и будут возвращены только ненулевые (n, bins, patches). По умолчанию False color : color or array_like of colors or None, optional Цвет или последовательность цветов, по одному на набор данных. По умолчанию (None) используется стандартная последовательность цветов линий. По умолчанию None label : string or None, optional Строка или последовательность строк для соответствия нескольким наборам данных. Гистограммы в виде столбцов дают несколько блоков на набор данных, но метку получает только первый, чтобы команда легенды работала как ожидается. по умолчанию None stacked : boolean, 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 Список блоков, используемых для построения гистограммы, или список таких списков, если передано несколько наборов входных данных.
Другие параметры:	**kwargs : Patch properties

См. также

hist2d

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

Примечания

Примечание

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

• Все аргументы с такими именами: 'weights', 'x'.

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

Текст в Pyplot

Демонстрация осей

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

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

Учебник по Pyplot