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=, 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.

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

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

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

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

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

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

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

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

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

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

Если marginals равно True, строится плотность по краям как прямоугольники на оси x и y.

extent4-tuple float, по умолчанию: 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

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

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

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

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

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

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

normstr или Normalize, необязательно

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

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

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

vmin, vmaxfloat, необязательно

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

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

Значение прозрачности, от 0 (прозрачный) до 1 (непрозрачный).

linewidthsfloat, по умолчанию: None

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

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

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

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

reduce_C_functioncallable, по умолчанию: 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	функция фильтра, которая принимает массив с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	массивоподобный объект или скаляр или None
animated	булево значение
antialiased или aa или antialiaseds	булево значение или список булевых значений
array	массивоподобный объект или None
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	Bbox
clip_on	булево значение
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	булево значение
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или dashes или linestyles или ls	строка или кортеж или список
linewidth или linewidths или lw	вещественное число или список вещественных чисел
mouseover	булево значение
norm	Normalize или строка или None
offset_transform или transOffset	неизвестно
offsets	(N, 2) или (2,) массивоподобный объект
path_effects	AbstractPathEffect
paths	список массивоподобных объектов
picker	None или булево значение или число с плавающей точкой или вызываемая функция
pickradius	неизвестно
rasterized	булево значение
sizes	массив NumPy или None
sketch_params	(scale: float, length: float, randomness: float)
snap	булево значение или None
transform	Transform
url	строка
urls	список строк или None
verts	список массивоподобных объектов
verts_and_codes	неизвестно
visible	булево значение
zorder	вещественное число

См. также

hist2d

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

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

График с гексагональными бинами

График с гексагональными бинами

hexbin(x, y, C)

hexbin(x, y, C)