matplotlib.axes.Axes.hexbin

Axes.hexbin(self, 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 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, подходящие значения min/max автоматически выбираются экземпляром Normalize (по умолчанию соответствующие min/max значения ячеек в случае линейного масштабирования по умолчанию). Это игнорируется, если задан 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 массив ndarray 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).

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

Демонстрация шестиугольных бинов