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=, 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' Используйте линейную или логарифмическую шкалу по горизонтальной оси. yscale{'linear', 'log'}, по умолчанию: 'linear' Используйте линейную или логарифмическую шкалу по вертикальной оси. mincntint > 0, по умолчанию: None Если не None, отображаются только ячейки с более чем mincnt количеством точек в ячейке. marginalsbool, по умолчанию: False Если marginals равно True, строит плотность полей как прямоугольники на основе цветовой карты по нижней части оси x и слева от оси y. extentfloat, по умолчанию: None Пределы ячеек. По умолчанию пределы назначаются на основе gridsize, x, y, xscale и yscale. Если xscale или yscale установлены в 'log', пределы ожидают показатель степени для степени 10. Например, для пределов x от 1 до 50 в линейной шкале и пределов y от 10 до 1000 в логарифмической шкале, введите (1, 50, 1, 3). Порядок скаляров (слева, справа, снизу, сверху).
Возвращает:	PolyCollection A PolyCollection определяющий гексагональные ячейки. PolyCollection.get_offsets содержит Mx2 массив, содержащий x, y координаты центров M гексагонов. PolyCollection.get_array содержит значения M гексагонов. Если marginals равно True, горизонтальная и вертикальная полосы (обе PolyCollections) будут присоединены к возвращаемому объекту как атрибуты hbar и vbar.
Другие параметры:	cmapstr или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis') Объект Colormap или имя зарегистрированной цветовой карты, используемый для отображения значений ячеек в цвета. normNormalize, необязательно Объект Normalize масштабирует значения ячеек до канонического диапазона цветовой карты [0, 1] для отображения в цвета. По умолчанию диапазон данных отображается в диапазоне цветовой полосы с помощью линейного масштабирования. vmin, vmaxfloat, по умолчанию: None Диапазон цветовой полосы. Если None, подходящие значения min/max автоматически выбираются объектом Normalize (по умолчанию - соответствующие минимальное/максимальное значения ячеек в случае линейного масштабирования). Использование 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: значение, взятое от наибольшей точки **kwargsPolyCollection свойства

Все остальные ключевые аргументы передаются в PolyCollection: Свойство Описание agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha массивоподобный объект, скаляр или None animated bool antialiased или aa или antialiaseds bool или список bool array массив ndarray или 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 contains неизвестно 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_position неизвестно offsets (N, 2) или (2,) массив-подобный объект path_effects AbstractPathEffect picker None или bool или float или вызываемая функция pickradius float rasterized bool sketch_params (scale: float, length: float, randomness: float) snap bool или None transform Transform url строка urls список строк или None visible bool zorder float

Примечания

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не вызывает исключение): x, y, C.

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

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

Демонстрация гексагональных диаграмм