matplotlib.pyplot.hist2d

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

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

Параметры:	x, yarray-like, shape (n, ) Входные значения binsNone 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. rangearray-like shape(2, 2), optional, default: None Левые и правые границы бинов вдоль каждого измерения (если не указаны явно в параметрах bins): [[xmin, xmax], [ymin, ymax]]. Все значения вне этого диапазона будут считаться выбросами и не будут учтены в гистограмме. densitybool, optional, default: False Нормализовать гистограмму. normed — устаревшее синонимичное название для этого параметра. weightsarray-like, shape (n, ), optional, default: None Массив весов w_i для каждого образца (x_i, y_i). cminscalar, optional, default: None Все бины с количеством элементов меньше cmin не будут отображаться (приводятся к NaN перед передачей в imshow), а соответствующие значения счётчика в возвращаемой гистограмме также будут установлены в nan. cmaxscalar, optional, default: None Все бины с количеством элементов больше cmax не будут отображаться (приводятся к NaN перед передачей в imshow), а соответствующие значения счётчика в возвращаемой гистограмме также будут установлены в nan.
Возвращаемое значение:	h2D array Двумерная гистограмма выборок x и y. Значения в x агрегируются по первому измерению, а значения в y — по второму. xedges1D array Границы бинов по оси x. yedges1D array Границы бинов по оси y. imageQuadMesh
Дополнительные параметры:	cmapColormap or str, optional Объект colors.Colormap. Если не указан, используется значение по умолчанию из rc настроек. normNormalize, optional Объект colors.Normalize используется для масштабирования данных яркости к [0, 1]. Если не указан, используется colors.Normalize() по умолчанию. vmin/vmaxNone or scalar, optional Аргументы, передаваемые объекту Normalize. alpha0 <= 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

Исследование различных нормализаций