matplotlib.axes.Axes.hist2d

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

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

Параметры:

x, yarray-like, форма (n, )

Векторы входных значений

binsNone или int или [int, int] или array-like или [array, array]

Параметры для задания бинов:

• Если int, количество бинов для двух измерений (nx = ny = bins).
• Если [int, int], количество бинов для каждого измерения (nx, ny = bins).
• Если array-like, границы бинов для двух измерений (x_edges = y_edges = bins).
• Если [array, array], границы бинов для каждого измерения (x_edges, y_edges = bins).

По умолчанию 10.

rangearray-like shape(2, 2), необязательно

Левая и правая границы бинов для каждого измерения (если не заданы явно в параметре bins): [[xmin, xmax], [ymin, ymax]]. Все значения вне этого диапазона будут считаться выбросами и не будут учтены в гистограмме.

densitybool, по умолчанию: False

Нормализовать гистограмму. См. документацию для параметра density в hist для подробностей.

weightsarray-like, форма (n, ), необязательно

Массив весов w_i для каждого образца (x_i, y_i).

cmin, cmaxfloat, по умолчанию: None

Все бины с количеством элементов меньше cmin или больше cmax не будут отображаться (будут установлены в NaN перед передачей в pcolormesh), а соответствующие значения в возвращаемом массиве подсчетов гистограммы также будут установлены в nan.

Возвращаемое значение:

h2D массив

Двумерная гистограмма выборок x и y. Значения x учитываются по первому измерению, значения y — по второму.

xedges1D массив

Границы бинов по оси x.

yedges1D массив

Границы бинов по оси y.

imageQuadMesh

Другие параметры:

cmapstr или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

Объект Colormap или зарегистрированное имя цветовой карты, используемое для отображения скалярных данных в цветах.

normstr или Normalize, необязательно

Метод нормализации, используемый для масштабирования скалярных данных в диапазон [0, 1] перед отображением в цветах с использованием cmap. По умолчанию используется линейное масштабирование, сопоставляющее минимальное значение с 0, а максимальное — с 1.

Если задано, это может быть одним из следующих:

• Экземпляр Normalize или его подкласс (см. Нормализация цветовых карт).
• Имя шкалы, например, "linear", "log", "symlog", "logit" и т. д. Список доступных шкал можно получить, вызвав matplotlib.scale.get_scale_names(). В этом случае динамически генерируется и создается соответствующий подкласс Normalize.

vmin, vmaxfloat, необязательно

Когда используются скалярные данные и нет явного norm, vmin и vmax определяют диапазон данных, который покрывает цветовая карта. По умолчанию цветовая карта покрывает весь диапазон значений предоставленных данных. Нельзя использовать vmin/vmax, когда задан экземпляр norm (но использование str norm вместе с vmin/vmax допустимо).

alpha0 <= scalar <= 1 или None, необязательно

Значение альфа-смешивания.

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения):

x, y, weights

**kwargs

Дополнительные параметры передаются методу pcolormesh и конструктору QuadMesh.

См. также

hist

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

hexbin

2D гистограмма с гексагональными бинами

Примечания

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

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

Гистограммы

Гистограммы

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

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

hist2d(x, y)

hist2d(x, y)