matplotlib.axes.Axes.hist

Axes.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 : 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'. Значение по умолчанию взято из параметра rcParam 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 — True, веса нормализуются так, что интеграл плотности по диапазону остаётся равным 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 Строка или последовательность строк, чтобы соответствовать нескольким наборам данных. Гистограммы в виде столбцов генерируют несколько наборов значений per набор данных, но только первое получает метку, чтобы команда legend работала как ожидается. значение по умолчанию — 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.axes.Axes.hist

Пример использования функции гистограммы (hist) с некоторыми дополнительными возможностями