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, yмассив-подобный объект

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

Cмассив-подобный объект, необязательно

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

gridsizeцелое число или (целое число, целое число), по умолчанию: 100

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

В качестве альтернативы, если кортеж (nx, ny), количество шестиугольников в направлениях x и y.

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

Дискретизация значений шестиугольника.

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

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

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

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

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

mincntцелое число > 0, по умолчанию: None

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

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

Если marginals равно True, строятся диаграммы распределения по краям x- и y-осей.

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

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

Если xscale или yscale установлены в 'log', пределы ожидаются как показатели степени 10. Например, для пределов x от 1 до 50 в линейной шкале и пределов y от 10 до 1000 в логарифмической шкале, следует указать (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 или зарегистрированное имя цветовой карты, используемое для сопоставления значений ячеек с цветами.

normNormalize, необязательно

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

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

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

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	число с плавающей точкой или список чисел с плавающей точкой
norm	Normalize или None
offset_transform	Transform
offsets	массив (N, 2) или (2,) или массив-подобный объект
path_effects	AbstractPathEffect
paths	список массивов-подобных объектов
picker	None или bool или float или вызываемая функция
pickradius	число с плавающей точкой
rasterized	bool
sizes	массив NumPy или 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