Spec-Zone.ru › Matplotlib 2.2

matplotlib.axes.Axes.hist2d

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

Создать график 2D гистограммы.

Параметры:
x, y: массив_подобный, форма (n, )

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

bins: [None | 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 : 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
Построение 1D гистограмм

Замечания

  • В настоящее время hist2d рассчитывает собственные пределы осей, и любые ранее заданные пределы игнорируются.
  • Вывод гистограммы с логарифмической цветовой шкалой осуществляется путем передачи объекта colors.LogNorm в ключевой параметр norm. Аналогично, нормализацию по степенному закону (похожую по эффекту на коррекцию гамма-каналов) можно выполнить с помощью colors.PowerNorm.

Примечание

В дополнение к описанным выше аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

  • Все аргументы со следующими именами: 'weights', 'x', 'y'.

© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/2.2.3/api/_as_gen/matplotlib.axes.Axes.hist2d.html

Spec-Zone.ru

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