matplotlib.axes.Axes.hexbin

Axes.hexbin(x, y, C=None, gridsize=100, bins=None, xscale='linear', yscale='linear', extent=None, cmap=None, norm=None, vmin=None, vmax=None, alpha=None, linewidths=None, edgecolors='face', reduce_C_function=<function mean>, mincnt=None, marginals=False, *, data=None, **kwargs)[source]

Создайте 2D-диаграмму гексагонального бинирования точек x, y.

Если C равно None, значение гексагона определяется количеством точек в гексагоне. В противном случае, C задаёт значения в координатах (x[i], y[i]). Для каждого гексагона эти значения сводятся с помощью reduce_C_function.

Параметры:

x, yarray-like

Позиции данных. x и y должны иметь одинаковую длину.

Carray-like, необязательно

Если задано, эти значения накапливаются в бинах. В противном случае, каждая точка имеет значение 1. Должно иметь одинаковую длину с x и y.

gridsizeint или (int, int), по умолчанию: 100

Если целое число, количество гексагонов в направлении x. Количество гексагонов в направлении y выбирается таким образом, чтобы гексагоны были приблизительно правильными.

В качестве альтернативы, если кортеж (nx, ny), количество гексагонов в направлениях x и y. В направлении y подсчёт выполняется по вертикально выстроенным гексагонам, а не по зигзагообразным цепочкам гексагонов; см. иллюстрацию ниже.

(Source code, png)

Для получения приблизительно правильных гексагонов выберите \(n_x = \sqrt{3}\,n_y\).

bins'log' или int или последовательность, по умолчанию: None

Дискретизация значений гексагонов.

• Если None, бинирование не применяется; цвет каждого гексагона напрямую соответствует его значению счётчика.
• Если 'log', использовать логарифмическую шкалу для цветовой карты. Внутренне, \(log_{10}(i+1)\) используется для определения цвета гексагона. Это эквивалентно norm=LogNorm().
• Если целое число, разделить счётчики на указанное количество бинов и окрасить гексагоны соответственно.
• Если последовательность значений, значения нижней границы бинов, которые будут использоваться.

xscale{'linear', 'log'}, по умолчанию: 'linear'

Использовать линейную или логарифмическую шкалу по оси абсцисс.

yscale{'linear', 'log'}, по умолчанию: 'linear'

Использовать линейную или логарифмическую шкалу по оси ординат.

mincntint > 0, по умолчанию: None

Если не None, отображать только ячейки с количеством точек, превышающим mincnt.

marginalsbool, по умолчанию: False

Если marginals равно True, построить маргинальную плотность в виде окрашенных прямоугольников вдоль нижней части оси абсцисс и слева по оси ординат.

extentкортеж из 4 чисел с плавающей точкой, по умолчанию: None

Пределы бинов (xmin, xmax, ymin, ymax). По умолчанию устанавливаются пределы на основе gridsize, x, y, xscale и yscale.

Если xscale или yscale установлены в 'log', пределы ожидаются как показатель степени для степени 10. Например, для пределов x от 1 до 50 в 'linear' шкале и пределов y от 10 до 1000 в 'log' шкале, введите (1, 50, 1, 3).

Возвращаемое значение:

PolyCollection

А PolyCollection определяющий гексагональные бины.

• PolyCollection.get_offsets содержит Mx2 массив, содержащий x, y координаты центров M гексагонов.
• PolyCollection.get_array содержит значения M гексагонов.

Если marginals равно True, горизонтальная и вертикальная полосы (оба PolyCollections) будут добавлены в возвращаемый объект как атрибуты hbar и vbar.

Другие параметры:

cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

Объект Colormap или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами.

normстрока или Normalize, необязательно

Метод нормализации, используемый для масштабирования скалярных данных до диапазона [0, 1] перед сопоставлением с цветами с помощью cmap. По умолчанию используется линейное масштабирование, сопоставляющее наименьшее значение с 0, а наибольшее - с 1.

Если задано, это может быть одно из следующих:

• Объект Normalize или один из его подклассов (см. Нормализация цветовых карт).
• Имя шкалы, например, "linear", "log", "symlog", "logit" и т. д. Список доступных шкал можно получить, вызвав matplotlib.scale.get_scale_names(). В этом случае, соответствующий подкласс Normalize динамически генерируется и инициализируется.

vmin, vmaxчисло с плавающей точкой, необязательно

При использовании скалярных данных и отсутствии явного norm, vmin и vmax определяют диапазон данных, который охватывает цветовая карта. По умолчанию цветовая карта охватывает весь диапазон значений предоставленных данных. Недопустимо использовать vmin/vmax при заданном объекте norm (но использование имени norm типа str вместе с vmin/vmax допустимо).

alphaчисло от 0 до 1, необязательно

Значение смешивания альфа-канала, между 0 (прозрачный) и 1 (непрозрачный).

linewidthsчисло с плавающей точкой, по умолчанию: None

Если None, по умолчанию равно 1.0.

edgecolors{'face', 'none', None} или цвет, по умолчанию: 'face'

Цвет границ гексагонов. Возможные значения:

• 'face': Рисует границы тем же цветом, что и заполнение.
• 'none': Границы не рисуются. Это иногда может привести к некрасивым неокрашенным пикселям между гексагонами.
• None: Рисует контуры в стандартном цвете.
• Явный цвет.

reduce_C_functionвызываемый объект, по умолчанию: numpy.mean

Функция агрегирования C в бинах. Она игнорируется, если C не задано. Она должна иметь сигнатуру:

def reduce_C_function(C: array) -> float

Обычно используемые функции:

• numpy.mean: среднее арифметическое точек
• numpy.sum: интеграл значений точек
• numpy.amax: значение из самой большой точки

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения):

x, y, C

**kwargsPolyCollection свойства

Все остальные ключевые аргументы передаются в PolyCollection:

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	массивоподобный объект или скаляр или None
animated	bool
antialiased или aa или antialiaseds	bool или список bool
array	массивоподобный объект или None
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	Bbox
clip_on	bool
clip_path	Объект Patch или (Path, Transform) или None
cmap	Colormap или строка или None
color	цвет или список кортежей RGBA
edgecolor или ec или edgecolors	цвет или список цветов или 'face'
facecolor или facecolors или fc	цвет или список цветов
figure	Figure
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или dashes или linestyles или ls	строка или кортеж или список из них
linewidth или linewidths или lw	число с плавающей точкой или список чисел с плавающей точкой
mouseover	bool
norm	Normalize или строка или None
offset_transform или transOffset	неизвестно
offsets	(N, 2) или (2,) массивоподобный объект
path_effects	AbstractPathEffect
paths	список массивоподобных объектов
picker	None или bool или число с плавающей точкой или вызываемая функция
pickradius	неизвестно
rasterized	bool
sizes	numpy.ndarray или None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	строка
urls	список строк или None
verts	список массивоподобных объектов
verts_and_codes	неизвестно
visible	bool
zorder	число с плавающей точкой

См. также

hist2d

Прямоугольные бины 2D гистограммы

Примеры использования matplotlib.axes.Axes.hexbin

Диаграмма с гексагональными ячейками

Диаграмма с гексагональными ячейками

hexbin(x, y, C)

hexbin(x, y, C)