Spec-Zone.ru › Matplotlib 3.3

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

Histograms

Гистограммы

Exploring normalizations

Изучение нормализации

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API