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