matplotlib.axes.Axes.hist2d
-
Axes.hist2d(x, y, bins=10, range=None, normed=False, weights=None, cmin=None, cmax=None, *, data=None, **kwargs) -
Построение 2D гистограммы.
Параметры: x, y: массив, форма (n, )
Входные значения
bins: [None | int | [int, int] | массив | [массив, массив]]
Указание бинов:
- Если int, то число бинов для двух измерений (nx=ny=bins).
- Если [int, int], то число бинов в каждом измерении (nx, ny = bins).
- Если массив, то границы бинов для двух измерений (x_edges=y_edges=bins).
- Если [массив, массив], то границы бинов в каждом измерении (x_edges, y_edges = bins).
Значение по умолчанию равно 10.
range : массив, форма (2, 2), необязательно, по умолчанию: None
Левые и правые границы бинов вдоль каждого измерения (если не указаны явно в параметрах bins): [[xmin, xmax], [ymin, ymax]]. Все значения вне этого диапазона будут считаться выбросами и не будут учитываться в гистограмме.
normed : boolean, необязательно, по умолчанию: False
Нормализовать гистограмму.
weights : массив, форма (n, ), необязательно, по умолчанию: None
Массив значений w_i, взвешивающих каждую выборку (x_i, y_i).
cmin : число, необязательно, по умолчанию: None
Все бины с количеством элементов меньше cmin не будут отображаться, а соответствующие значения в возвращаемой гистограмме будут установлены в nan.
cmax : число, необязательно, по умолчанию: None
Все бины с количеством элементов больше cmax не будут отображаться (устанавливаются в none перед передачей в imshow), а соответствующие значения в возвращаемой гистограмме будут установлены в nan.
Возвращает: Возвращаемое значение -
(counts, xedges, yedges, Image).Другие параметры: cmap : {Colormap, строка}, необязательно
Экземпляр
matplotlib.colors.Colormap. Если не задан, используется значение по умолчанию из rc настроек.norm : Normalize, необязательно
Экземпляр
matplotlib.colors.Normalizeиспользуется для масштабирования данных яркости к[0, 1]. Если не задан, используетсяNormalize().vmin/vmax : {None, число}, необязательно
Аргументы, передаваемые экземпляру
Normalize.alpha :
0 <= scalar <= 1илиNone, необязательноЗначение альфа-смешивания.
См. также
-
hist - 1D гистограмма
Примечания
Отображение гистограммы с логарифмической цветовой шкалой достигается путем передачи экземпляра
colors.LogNormв качестве ключевого аргумента norm. Аналогично, нормализация с помощью степенной функции (похожая по эффекту на коррекцию гамма-каналов) может быть достигнута с помощьюcolors.PowerNorm.Примечание
Помимо вышеописанных аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:
- Все аргументы с именами: ‘weights’, ‘x’, ‘y’.
© 2012–2017 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
http://matplotlib.org/2.1.0/api/_as_gen/matplotlib.axes.Axes.hist2d.html