matplotlib.axes.Axes.hist2d

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

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

Параметры:	x, y : array_like, shape (n, ) Входные значения bins : None or int or [int, int] or array_like or [array, array] Указание бинов: Если целое число, то число бинов для двух измерений (nx=ny=bins). Если кортеж, то число бинов для каждого измерения (nx, ny = bins). Если массив, то границы бинов для двух измерений (x_edges=y_edges=bins). Если кортеж, то границы бинов для каждого измерения (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

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

Примечания

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

Примечание

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

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

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

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

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