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, 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]]. Все значения вне этого диапазона будут считаться выбросами и не будут учитываться в гистограмме. 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. Если не указан, используется значение по умолчанию из 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

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