matplotlib.pyplot.hexbin

matplotlib.pyplot.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.

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.

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 или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами.

normстрока или 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 (непрозрачный).

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	функция фильтра, которая принимает массив чисел с плавающей точкой (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 или 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 гистограммы