matplotlib.axes.Axes.hist2d
-
Axes.hist2d(x, y, bins=10, range=None, density=False, weights=None, cmin=None, cmax=None, *, data=None, **kwargs)[source] -
Построение 2D гистограммы.
Параметры: - x, yмассив-подобный объект, форма (n, )
-
Вводные значения
- binsNone или 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массив-подобный объект, форма (2, 2), необязательно
-
Левая и правая границы бинов вдоль каждого измерения (если не указаны явно в параметрах bins):
[[xmin, xmax], [ymin, ymax]]. Все значения вне этого диапазона будут считаться выбросами и не будут учтены в гистограмме. - densitybool, по умолчанию: False
-
Нормализовать гистограмму. Смотрите документацию для параметра density в
histдля получения более подробной информации. - weightsмассив-подобный объект, форма (n, ), необязательно
-
Массив значений w_i, взвешивающих каждую выборку (x_i, y_i).
- cmin, cmaxfloat, по умолчанию: None
-
Все бины, у которых количество меньше cmin или больше cmax, не будут отображаться (устанавливаются в NaN перед передачей в imshow), и эти значения количества в возвращаемой гистограмме также будут установлены в nan при возврате.
Возвращаемое значение: - h2D массив
-
Двумерная гистограмма выборок x и y. Значения в x группируются по первому измерению, а значения в y — по второму измерению.
- xedges1D массив
-
Границы бинов по оси x.
- yedges1D массив
-
Границы бинов по оси y.
-
image
QuadMesh
Другие параметры: - cmapЦветовая карта или строка, необязательно
-
Экземпляр
colors.Colormap. Если не указан, используются настройки rc. - normНормализация, необязательно
-
Экземпляр
colors.Normalizeиспользуется для масштабирования данных яркости к[0, 1]. Если не указан, используетсяcolors.Normalize(). - vmin/vmaxNone или число, необязательно
-
Аргументы, передаваемые экземпляру
Normalize. -
alpha
0 <= scalar <= 1илиNone, необязательно -
Значение прозрачности.
- **kwargs
-
Дополнительные параметры передаются методу
pcolormeshи конструкторуQuadMesh.
См. также
hist- Построение 1D гистограмм
Примечания
- В настоящее время
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–2021 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.4.3/api/_as_gen/matplotlib.axes.Axes.hist2d.html