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 0x7fba59dfc310>, 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' Использовать линейную или логарифмическую (log10) шкалу по горизонтали. yscale{'linear', 'log'}, default: 'linear' Использовать линейную или логарифмическую (log10) шкалу по вертикали. 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). Порядок скаляров (слева, справа, снизу, сверху).
Возвращаемое значение:	PolyCollection PolyCollection, определяющий шестиугольные ячейки. PolyCollection.get_offsets содержит массив Mx2, содержащий позиции x, y центров M шестиугольников. PolyCollection.get_array содержит значения M шестиугольников. Если marginals равно True, горизонтальная и вертикальная полосы (обе PolyCollections) будут добавлены к возвращаемой коллекции в качестве атрибутов hbar и vbar.
Другие параметры:	cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis') Экземпляр Colormap или зарегистрированное имя цветовой карты, используемое для сопоставления значений ячеек с цветами. normNormalize, optional Экземпляр Normalize масштабирует значения ячеек до стандартного диапазона цветовой карты [0, 1] для отображения цветов. По умолчанию диапазон данных отображается в диапазоне цветовой панели с линейным масштабированием. vmin, vmaxfloat, default: None Диапазон цветовой панели. Если None, подходящие минимальные/максимальные значения автоматически выбираются экземпляром Normalize (по умолчанию соответствует соответствующим минимальным/максимальным значениям ячеек в случае линейного масштабирования). Использование vmin/vmax устарело, если задан 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: Рисовать контуры в стандартном цвете. Явный цвет. reduce_C_functioncallable, default: numpy.mean Функция для агрегирования C в ячейках. Она игнорируется, если C не задано. Она должна иметь следующий сигнатура: def reduce_C_function(C: array) -> float Обычно используемые функции: numpy.mean: среднее значение точек numpy.sum: интеграл значений точек numpy.max: значение, взятое от точки с наибольшим значением **kwargsPolyCollection properties

Все остальные ключевые аргументы передаются в PolyCollection: Свойство Описание agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha float или None animated bool antialiased или aa или antialiaseds bool или список bool array ndarray capstyle {'butt', 'round', 'projecting'} 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 {'miter', 'round', 'bevel'} label объект linestyle или dashes или linestyles или ls строка или кортеж или список из них linewidth или linewidths или lw float или список float norm Normalize или None offset_position неизвестно offsets массив-подобный (N, 2) или (2,) path_effects AbstractPathEffect picker None или bool или вызываемый объект pickradius неизвестно rasterized bool или None 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.

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

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

Демонстрация использования hexbin