matplotlib.pyplot.hist2d

matplotlib.pyplot.hist2d(x, y, bins=10, range=None, normed=False, weights=None, cmin=None, cmax=None, hold=None, data=None, **kwargs) [source]

Создаёт график двумерной гистограммы.

Параметры:	x, y: array_like, форма (n, ) Входные значения bins: [None | 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. range : array_like shape(2, 2), optional, default: None Левые и правые границы бинов вдоль каждого измерения (если не указаны явно в параметрах bins): [[xmin, xmax], [ymin, ymax]]. Все значения за пределами этого диапазона будут считаться выбросами и не учитываться в гистограмме. normed : boolean, optional, default: False Нормализовать гистограмму. 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 : AxesImage
Другие параметры:	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'.