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, 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

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

Примечания

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

Примечание

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

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

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

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

Гистограммы

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