matplotlib.pyplot.hist2d

matplotlib.pyplot.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), и эти значения количества в возвращаемой гистограмме также будут установлены в nan при возврате.

Возвращает

h2D массив: Двумерная гистограмма выборок x и y. Значения x учитываются по первому измерению, а значения y — по второму.
xedges1D массив: Границы бинов по оси x.
yedges1D массив: Границы бинов по оси y.
imageQuadMesh

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

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

Экземпляр colors.Colormap. Если не задано, используется значение по умолчанию из rc параметров.

normНормализация, необязательно

Экземпляр 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.