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

Несколько наборов данных могут быть предоставлены через 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' или '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. Этот параметр можно использовать для построения гистограммы данных, которые уже сгруппированы, например, с использованием np.histogram (рассматривая каждый бин как одну точку с весом, равным его счету). counts, bins = np.histogram(data) plt.hist(bins[:-1], bins, weights=counts) (или вы можете альтернативно использовать bar()). 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 Строка или последовательность строк для соответствия нескольким наборам данных. Гистограммы в виде столбцов возвращают несколько областей для каждого набора данных, но только первая получает метку, чтобы команда legend работала как ожидается. По умолчанию None stacked : bool, optional Если True, несколько наборов данных накладываются друг на друга. Если False несколько наборов данных располагаются рядом, если histtype 'bar', или друг над другом, если histtype 'step'. По умолчанию False normed : bool, optional Устарело; используйте параметр density вместо него.
Возвращаемое значение:	n : array or list of arrays Значения бинов гистограммы. См. density и weights для описания возможной семантики. Если вход x является массивом, то это массив длины nbins. Если вход является последовательностью массивов [data1, data2,..], то это список массивов со значениями гистограмм для каждого из массивов в том же порядке. Тип данных массива n (или его элементов) всегда будет float, даже если не используется взвешивание или нормализация. bins : array Границы бинов. Длина nbins + 1 (nbins левых границ и правая граница последнего бина). Всегда один массив, даже при передаче нескольких наборов данных. patches : list or list of lists Список отдельных областей, используемых для создания гистограммы, или список таких списков, если передано несколько наборов данных.
Другие параметры:	**kwargs : Patch properties

См. также

hist2d

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

Примечания

Примечание

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

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

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

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

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

Текст Pyplot

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

Учебник по Pyplot

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