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)

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

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

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

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

Параметры:

Параметры:	x : (n,) массив или последовательность (n,) массивов Вводные значения, принимаются как одиночный массив или последовательность массивов, причём длины массивов необязательно должны совпадать bins : целое число, array_like или ‘auto’, необязательно Если задано целое число, `bins + 1` возвращаются значения границ интервалов, в соответствии с `numpy.histogram()` для версии numpy >= 1.3. Поддерживаются интервалы с неравномерным шагом, если bins является последовательностью. Если установлена библиотека NumPy 1.11, также может быть `'auto'`. По умолчанию используется значение из параметра rc `hist.bins`. range : кортеж или None, необязательно Диапазон нижней и верхней границ интервалов. Значения вне диапазона игнорируются. Если не указан, range имеет значение `(x.min(), x.max())`. Параметр range не имеет эффекта, если bins является последовательностью. Если bins является последовательностью или range задан, автоматическое масштабирование основано на заданном диапазоне интервалов вместо диапазона x. Значение по умолчанию `None` density : boolean, необязательно Если `True`, первый элемент возвращаемого кортежа будет нормализованным значением счётчика, чтобы получить плотность вероятности, т.е., площадь (или интеграл) под гистограммой будет равна 1. Это достигается путём деления счётчика на количество наблюдений, умноженное на ширину интервала, а не на общее количество наблюдений. Если также задан stacked, сумма гистограмм будет нормализована до 1. Значение по умолчанию `None` для обоих normed и density. Если один из них установлен, то будет использовано это значение. Если ни один из них не установлен, то аргументы будут обработаны как `False`. Если оба density и normed заданы, возникает ошибка. weights : (n, ) array_like или None, необязательно Массив весов, с тем же размером, что и x. Каждое значение в x вносит свой связанный вес в счётчик интервалов (вместо 1). Если normed или density `True`, веса нормализуются, так что интеграл плотности в заданном диапазоне остаётся равным 1. Значение по умолчанию `None` cumulative : boolean, необязательно Если `True`, вычисляется гистограмма, где каждый интервал даёт количество точек в данном интервале плюс все точки в более мелких интервалах. Последний интервал даёт общее количество точек данных. Если также заданы normed или density, то гистограмма нормализуется таким образом, что последний интервал равен 1. Если cumulative имеет значение меньше 0 (например, -1), направление накопления меняется. В этом случае, если также заданы normed и/или density, гистограмма нормализуется так, что первый интервал равен 1. Значение по умолчанию `False` bottom : array_like, скаляр или None Положение нижней границы каждого интервала. Если скаляр, нижняя граница каждого интервала смещается на одинаковое значение. Если массив, каждый интервал смещается независимо, и длина массива должна совпадать с количеством интервалов. Если None, значение по умолчанию 0. Значение по умолчанию `None` histtype : {‘bar’, ‘barstacked’, ‘step’, ‘stepfilled’}, необязательно Тип гистограммы. ‘bar’ — традиционная гистограмма в виде столбцов. Если задано несколько наборов данных, столбцы располагаются рядом. ‘barstacked’ — гистограмма в виде столбцов, где несколько наборов данных накладываются друг на друга. ‘step’ генерирует график линией, по умолчанию без заливки. ‘stepfilled’ генерирует график линией, по умолчанию залитый. Значение по умолчанию ‘bar’ align : {‘left’, ‘mid’, ‘right’}, необязательно Управление выводом гистограммы. ‘left’: столбцы центрированы по левой границе интервалов. ‘mid’: столбцы центрированы между границами интервалов. ‘right’: столбцы центрированы по правой границе интервалов. Значение по умолчанию ‘mid’ orientation : {‘horizontal’, ‘vertical’}, необязательно Если ‘horizontal’, `barh` будет использоваться для гистограмм в виде столбцов, и параметр bottom будет обозначать левую границу. rwidth : скаляр или None, необязательно Относительная ширина столбцов как доля ширины интервала. Если `None`, ширина вычисляется автоматически. Игнорируется, если histtype — ‘step’ или ‘stepfilled’. Значение по умолчанию `None` log : boolean, необязательно Если `True`, ось гистограммы будет задана в логарифмическом масштабе. Если log `True` и x — одномерный массив, пустые интервалы будут отфильтрованы, и будут возвращены только непустые `(n, bins, patches)`. Значение по умолчанию `False` color : цвет или массив цветов или None, необязательно Спецификация цвета или последовательность спецификаций цвета, по одной на набор данных. По умолчанию (`None`) используется стандартная последовательность цветов для линий. Значение по умолчанию `None` label : строка или None, необязательно Строка или последовательность строк, соответствующая нескольким наборам данных. Гистограммы в виде столбцов возвращают несколько областей для каждого набора данных, но только первая получает метку, так что команда legend будет работать как ожидается. Значение по умолчанию `None` stacked : boolean, необязательно Если `True`, несколько наборов данных накладываются друг на друга Если `False` несколько наборов данных располагаются рядом, если histtype — ‘bar’, или друг над другом, если histtype — ‘step’ Значение по умолчанию `False`
Возвращаемое значение:	n : массив или список массивов Значения интервалов гистограммы. См. normed или density и weights для описания возможных семантик. Если вход x — массив, то это массив длины nbins. Если вход — последовательность массивов `[data1, data2,..]`, то это список массивов со значениями гистограмм для каждого из массивов в том же порядке. bins : массив Границы интервалов. Длина nbins + 1 (nbins левых границ и правая граница последнего интервала). Всегда единственный массив, даже когда передаются несколько наборов данных. patches : список или список списков Список индивидуальных областей, используемых для создания гистограммы, или список таких списков, если передано несколько наборов входных данных.
Другие параметры:
	**kwargs : `Patch` свойства

x : (n,) массив или последовательность (n,) массивов

Вводные значения, принимаются как одиночный массив или последовательность массивов, причём длины массивов необязательно должны совпадать

bins : целое число, array_like или ‘auto’, необязательно

Если задано целое число, bins + 1 возвращаются значения границ интервалов, в соответствии с numpy.histogram() для версии numpy >= 1.3.

Поддерживаются интервалы с неравномерным шагом, если bins является последовательностью.

Если установлена библиотека NumPy 1.11, также может быть 'auto'.

По умолчанию используется значение из параметра rc hist.bins.

range : кортеж или None, необязательно

Диапазон нижней и верхней границ интервалов. Значения вне диапазона игнорируются. Если не указан, range имеет значение (x.min(), x.max()). Параметр range не имеет эффекта, если bins является последовательностью.

Если bins является последовательностью или range задан, автоматическое масштабирование основано на заданном диапазоне интервалов вместо диапазона x.

Значение по умолчанию None

density : boolean, необязательно

Если True, первый элемент возвращаемого кортежа будет нормализованным значением счётчика, чтобы получить плотность вероятности, т.е., площадь (или интеграл) под гистограммой будет равна 1. Это достигается путём деления счётчика на количество наблюдений, умноженное на ширину интервала, а не на общее количество наблюдений. Если также задан stacked, сумма гистограмм будет нормализована до 1.

Значение по умолчанию None для обоих normed и density. Если один из них установлен, то будет использовано это значение. Если ни один из них не установлен, то аргументы будут обработаны как False.

Если оба density и normed заданы, возникает ошибка.

weights : (n, ) array_like или None, необязательно

Массив весов, с тем же размером, что и x. Каждое значение в x вносит свой связанный вес в счётчик интервалов (вместо 1). Если normed или density True, веса нормализуются, так что интеграл плотности в заданном диапазоне остаётся равным 1.

Значение по умолчанию None

cumulative : boolean, необязательно

Если True, вычисляется гистограмма, где каждый интервал даёт количество точек в данном интервале плюс все точки в более мелких интервалах. Последний интервал даёт общее количество точек данных. Если также заданы normed или density, то гистограмма нормализуется таким образом, что последний интервал равен 1. Если cumulative имеет значение меньше 0 (например, -1), направление накопления меняется. В этом случае, если также заданы normed и/или density, гистограмма нормализуется так, что первый интервал равен 1.

Значение по умолчанию False

bottom : array_like, скаляр или None

Положение нижней границы каждого интервала. Если скаляр, нижняя граница каждого интервала смещается на одинаковое значение. Если массив, каждый интервал смещается независимо, и длина массива должна совпадать с количеством интервалов. Если None, значение по умолчанию 0.

Значение по умолчанию None

histtype : {‘bar’, ‘barstacked’, ‘step’, ‘stepfilled’}, необязательно

Тип гистограммы.

‘bar’ — традиционная гистограмма в виде столбцов. Если задано несколько наборов данных, столбцы располагаются рядом.
‘barstacked’ — гистограмма в виде столбцов, где несколько наборов данных накладываются друг на друга.
‘step’ генерирует график линией, по умолчанию без заливки.
‘stepfilled’ генерирует график линией, по умолчанию залитый.

Значение по умолчанию ‘bar’

align : {‘left’, ‘mid’, ‘right’}, необязательно

Управление выводом гистограммы.

‘left’: столбцы центрированы по левой границе интервалов.
‘mid’: столбцы центрированы между границами интервалов.
‘right’: столбцы центрированы по правой границе интервалов.

Значение по умолчанию ‘mid’

orientation : {‘horizontal’, ‘vertical’}, необязательно

Если ‘horizontal’, barh будет использоваться для гистограмм в виде столбцов, и параметр bottom будет обозначать левую границу.

rwidth : скаляр или None, необязательно

Относительная ширина столбцов как доля ширины интервала. Если None, ширина вычисляется автоматически.

Игнорируется, если histtype — ‘step’ или ‘stepfilled’.

Значение по умолчанию None

log : boolean, необязательно

Если True, ось гистограммы будет задана в логарифмическом масштабе. Если log True и x — одномерный массив, пустые интервалы будут отфильтрованы, и будут возвращены только непустые (n, bins, patches).

Значение по умолчанию False

color : цвет или массив цветов или None, необязательно

Спецификация цвета или последовательность спецификаций цвета, по одной на набор данных. По умолчанию (None) используется стандартная последовательность цветов для линий.

Значение по умолчанию None

label : строка или None, необязательно

Строка или последовательность строк, соответствующая нескольким наборам данных. Гистограммы в виде столбцов возвращают несколько областей для каждого набора данных, но только первая получает метку, так что команда legend будет работать как ожидается.

Значение по умолчанию None

stacked : boolean, необязательно

Если True, несколько наборов данных накладываются друг на друга Если False несколько наборов данных располагаются рядом, если histtype — ‘bar’, или друг над другом, если histtype — ‘step’

Значение по умолчанию False

Возвращаемое значение:

n : массив или список массивов

Значения интервалов гистограммы. См. normed или density и weights для описания возможных семантик. Если вход x — массив, то это массив длины nbins. Если вход — последовательность массивов [data1, data2,..], то это список массивов со значениями гистограмм для каждого из массивов в том же порядке.

bins : массив

Границы интервалов. Длина nbins + 1 (nbins левых границ и правая граница последнего интервала). Всегда единственный массив, даже когда передаются несколько наборов данных.

patches : список или список списков

Список индивидуальных областей, используемых для создания гистограммы, или список таких списков, если передано несколько наборов входных данных.

Другие параметры:

**kwargs : Patch свойства

См. также

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

Примечания

До версии NumPy 1.5 функция гистограммы NumPy была некорректной при normed=True в случае неравномерного размера интервалов. MPL унаследовал эту ошибку. Сейчас она исправлена в MPL при использовании более ранних версий NumPy.

Примечание

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

Все аргументы с именами: ‘weights’, ‘x’.