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, yмассив-подобный объект, форма (n, )

Входные значения

binsNone или int или [int, int] или массив-подобный объект или [массив, массив]

Указание бинов:

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

Значение по умолчанию 10.

rangeмассив-подобный объект формы (2, 2), необязательно

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

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

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

weightsмассив-подобный объект, форма (n, ), необязательно

Массив значений w_i, взвешивающих каждую выборку (x_i, y_i).

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

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

Возвращает

h2D массив

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

xedges1D массив

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

yedges1D массив

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

imageQuadMesh

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

cmapЦветовая карта или строка, необязательно

Объект colors.Colormap. Если не задано, используются настройки rc.

normNormalize, необязательно

Объект colors.Normalize используется для масштабирования данных яркости до [0, 1]. Если не задано, используется по умолчанию colors.Normalize().

vmin/vmaxNone или скаляр, необязательно

Аргументы, передаваемые в объект Normalize.

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