matplotlib.axes.Axes.hist2d

Axes.hist2d(self, x, y, bins=10, range=None, density=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]]. Все значения за пределами этого диапазона будут считаться выбросами и не будут учитываться в гистограмме. density : bool, optional, default: False Нормализовать гистограмму. normed - устаревшее название для этого параметра. 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. Если не указан, используются настройки по умолчанию. 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

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