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)

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

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

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

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

Параметры:

Параметры:	x : массив (n,) или последовательность массивов (n,) Вводные значения, принимается либо один массив, либо последовательность массивов, причём длина массивов не обязана быть одинаковой bins : целое число, массив или ‘auto’, необязательно Если задано целое число, `bins + 1` возвращаются границами интервалов, согласуясь с `numpy.histogram()` для версий numpy >= 1.3. Поддерживаются интервалы с неравномерной шириной, если bins — последовательность. Если установлен Numpy 1.11, также может быть `'auto'`. По умолчанию используется значение из параметра rcParam `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,) или None, необязательно Массив весов, с той же формой, что и x. Каждое значение в x вносит свой связанный вес в подсчёт интервала (вместо 1). Если установлен normed или density, веса нормализуются, так что интеграл плотности в заданном диапазоне остаётся равным 1. По умолчанию `None` cumulative : boolean, необязательно Если `True`, вычисляется гистограмма, где каждый интервал содержит количество в данном интервале плюс все интервалы с меньшими значениями. Последний интервал даёт общее число точек данных. Если также установлен normed или density, гистограмма нормализуется так, что последний интервал равен 1. Если cumulative принимает значение меньше 0 (например, -1), направление накопления меняется. В этом случае, если normed и/или density также `True`, гистограмма нормализуется так, что первый интервал равен 1. По умолчанию `False` bottom : массив, скаляр или None Положение нижней границы каждого интервала. Если скаляр, нижняя граница каждого интервала сдвигается на одно и то же значение. Если массив, каждый интервал сдвигается независимо, и длина массива bottom должна совпадать с количеством интервалов. Если 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 : целое число, массив или ‘auto’, необязательно

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

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

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

По умолчанию используется значение из параметра rcParam 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,) или None, необязательно

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

По умолчанию None

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

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

По умолчанию False

bottom : массив, скаляр или None

Положение нижней границы каждого интервала. Если скаляр, нижняя граница каждого интервала сдвигается на одно и то же значение. Если массив, каждый интервал сдвигается независимо, и длина массива bottom должна совпадать с количеством интервалов. Если 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 histogram имела ошибку normed=True при неравномерных размерах интервалов. MPL унаследовал эту ошибку. Сейчас она исправлена в MPL при использовании более ранних версий numpy.

Примечание

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

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

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

matplotlib.pyplot.hist

Примечания

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

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