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]

Построение диаграммы рассеяния с гексагональными ячейками для точек 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 float, по умолчанию: 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 массив, содержащий координаты центров M гексагонов.
• PolyCollection.get_array содержит значения M гексагонов.

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

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

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

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

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

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

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

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

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

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

linewidthsfloat, по умолчанию: 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 или str или None
color	цвет или список rgba-кортежей
edgecolor или ec или edgecolors	цвет или список цветов или 'face'
facecolor или facecolors или fc	цвет или список цветов
figure	Figure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или dashes или linestyles или ls	строка или кортеж или список таких
linewidth или linewidths или lw	float или список float
norm	Normalize или None
offset_transform	Transform
offsets	(N, 2) или (2,) массивоподобный объект
path_effects	AbstractPathEffect
paths	список массивоподобных объектов
picker	None или bool или float или вызываемый объект
pickradius	float
rasterized	bool
sizes	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	float

См. также

hist2d

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