matplotlib.axes.Axes.hist2d
-
Axes.hist2d(self, 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.axes.Axes.hist2d
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.3.3/api/_as_gen/matplotlib.axes.Axes.hist2d.html