matplotlib.pyplot.hist2d

matplotlib.pyplot.hist2d(x, y, bins=10, range=None, normed=False, weights=None, cmin=None, cmax=None, *, data=None, **kwargs) [source]

Построение двумерной гистограммы.

Параметры:	x, y : array_like, shape (n, ) Входные значения bins : None or int or [int, int] or array_like or [array, array] Указание бинов: Если целое число, то количество бинов для двух измерений (nx=ny=bins). Если [int, int], то количество бинов в каждом измерении (nx, ny = bins). Если массив, то границы бинов для двух измерений (x_edges=y_edges=bins). Если [array, array], то границы бинов в каждом измерении (x_edges, y_edges = bins). По умолчанию 10. range : array_like shape(2, 2), optional, default: None Левая и правая границы бинов по каждому измерению (если не указаны явно в параметрах bins): [[xmin, xmax], [ymin, ymax]]. Все значения вне этого диапазона будут считаться выбросами и не будут учитываться в гистограмме. normed : bool, optional, default: False Нормализовать гистограмму. weights : array_like, shape (n, ), optional, default: None Массив весов w_i для каждого образца (x_i, y_i). cmin : scalar, optional, default: None Все бины с количеством элементов меньше cmin не будут отображаться, и соответствующие значения в возвращаемой гистограмме будут установлены в nan. cmax : scalar, optional, default: None Все бины с количеством элементов больше cmax не будут отображаться (будут установлены в None перед передачей в imshow), и соответствующие значения в возвращаемой гистограмме будут установлены в nan.
Возвращает:	h : 2D array Двумерная гистограмма выборок x и y. Значения в x гистограммируются по первому измерению, значения в y – по второму. xedges : 1D array Границы бинов по оси x. yedges : 1D array Границы бинов по оси y. image : QuadMesh
Другие параметры:	cmap : Colormap or str, optional Экземпляр colors.Colormap. Если не указан, используются настройки rc. norm : Normalize, optional Экземпляр colors.Normalize используется для масштабирования данных яркости до [0, 1]. Если не указан, по умолчанию используется colors.Normalize(). vmin/vmax : None or scalar, optional Аргументы, передаваемые экземпляру Normalize. alpha : 0 <= scalar <= 1 or None, optional Значение альфа-смешивания.

См. также

hist

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

Примечания

• В настоящее время hist2d вычисляет собственные пределы осей, и любые ранее установленные пределы игнорируются.
• Для построения гистограммы с логарифмической цветовой шкалой необходимо передать экземпляр colors.LogNorm в ключевой аргумент norm. Аналогично, нормализацию по степенной функции (аналогично коррекции гамма) можно осуществить с помощью colors.PowerNorm.

Примечание

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

• Все аргументы со следующими именами: 'weights', 'x', 'y'.

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

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

Изучение нормализаций