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 at 0x7f61654ae5e0>, 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, optional Если задано, эти значения накапливаются в ячейках. В противном случае каждая точка имеет значение 1. Должно иметь такую же длину, как x и y. gridsizeint or (int, int), default: 100 Если целое число, количество гексагонов в направлении x. Количество гексагонов в направлении y выбирается таким образом, чтобы гексагоны были приблизительно правильными. В качестве альтернативы, если кортеж (nx, ny), количество гексагонов в направлениях x и y. bins'log' or int or sequence, default: None Дискретизация значений гексагонов. Если None, никакой дискретизации не применяется; цвет каждого гексагона напрямую соответствует его количеству. Если 'log', используется логарифмическая шкала для цветовой карты. Внутренне используется \(log_{10}(i+1)\) для определения цвета гексагона. Это эквивалентно norm=LogNorm(). Если целое число, разделите подсчёты на указанное количество ячеек и соответственно раскрасьте гексагоны. Если последовательность значений, значения нижней границы ячеек, которые будут использоваться. xscale{'linear', 'log'}, default: 'linear' Использование линейной или логарифмической шкалы по горизонтальной оси. yscale{'linear', 'log'}, default: 'linear' Использование линейной или логарифмической шкалы по вертикальной оси. mincntint > 0, default: None Если не None, отображаются только ячейки с более чем mincnt точками в ячейке. marginalsbool, default: False Если marginals равно True, отображается предельная плотность в виде цветных прямоугольников внизу оси x и слева от оси y. extentfloat, default: None Пределы ячеек. По умолчанию пределы устанавливаются на основе gridsize, x, y, xscale и yscale. Если xscale или yscale установлено в 'log', пределы ожидаются как показатель степени 10. Например, для пределов x от 1 до 50 в 'линейной' шкале и пределов y от 10 до 1000 в 'логарифмической' шкале введите (1, 50, 1, 3). Порядок скаляров (слева, справа, снизу, сверху).
Возвращает:	polycollectionPolyCollection A PolyCollection определяющий гексагональные ячейки. PolyCollection.get_offset содержит массив Mx2, содержащий x, y координаты центров M гексагонов. PolyCollection.get_array содержит значения M гексагонов. Если marginals равно True, горизонтальная и вертикальная полосы (оба PolyCollections) будут добавлены к возвращаемому объекту в качестве атрибутов hbar и vbar.
Другие параметры:	cmapstr or Colormap, optional Экземпляр Colormap или зарегистрированное имя цветовой карты, используемое для сопоставления значений ячеек с цветами. По умолчанию rcParams["image.cmap"] (по умолчанию: 'viridis'). normNormalize, optional Экземпляр Normalize масштабирует значения ячеек до стандартного цветового диапазона [0, 1] для сопоставления с цветами. По умолчанию диапазон данных сопоставляется с диапазоном цветовой шкалы с использованием линейного масштабирования. vmin, vmaxfloat, optional, default: None Диапазон цветовой шкалы. Если None, подходящие минимальные и максимальные значения автоматически выбираются экземпляром Normalize (по умолчанию соответствующие минимальные/максимальные значения ячеек в случае линейного масштабирования по умолчанию). Это игнорируется, если задан norm. alphafloat between 0 and 1, optional Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). linewidthsfloat, default: None Если None, по умолчанию равно 1.0. edgecolors{'face', 'none', None} or color, default: 'face' Цвет краёв гексагонов. Возможные значения: 'face': Рисует края в том же цвете, что и цвет заливки. 'none': Края не рисуются. Это иногда может привести к некрасивым непрокрашенным пикселям между гексагонами. None: Рисует контуры в стандартном цвете. Явный цвет matplotlib. reduce_C_functioncallable, default is numpy.mean Функция для агрегации C в ячейках. Она игнорируется, если C не задано. Она должна иметь сигнатуру: def reduce_C_function(C: array) -> float Обычно используемые функции: numpy.mean: среднее значение точек numpy.sum: интеграл значений точек numpy.max: значение, взятое от самой большой точки **kwargsPolyCollection properties

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

Примечания

Примечание

Помимо описанных выше аргументов, эта функция может принимать аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все аргументы со следующими именами: 'x', 'y'.

Объекты, переданные как data, должны поддерживать доступ по элементам (data[<arg>]) и проверку на членство (<arg> in data).