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 Левые и правые границы бинов вдоль каждого измерения (если не указаны явно в параметрах bins): [[xmin, xmax], [ymin, ymax]]. Все значения вне этого диапазона будут считаться выбросами и не будут учитываться в гистограмме. densitybool, default: False Нормализовать гистограмму. См. документацию параметра density для hist для получения дополнительных деталей. weightsarray-like, shape (n, ), optional Массив значений w_i, взвешивающих каждую выборку (x_i, y_i). cmin, cmaxfloat, default: None Все бины, у которых количество меньше, чем cmin, или больше, чем 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 Значение альфа-смешивания. **kwargs Дополнительные параметры передаются методу pcolormesh и конструктору QuadMesh.

См. также

hist

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

Примечания

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

Примечание

Помимо вышеописанных аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не вызывает исключение): x, y, weights.

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

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

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