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 0x7f80975d6ae8>, mincnt=None, marginals=False, *, data=None, **kwargs) [source]

Построение диаграммы с гексагональными ячейками.

Построение диаграммы с гексагональными ячейками для x по отношению к y, где x и y — одномерные последовательности одной длины, N. Если C равно None (по умолчанию), это гистограмма числа наблюдений в точках (x[i],y[i]).

Если C указано, оно определяет значения в координатах (x[i], y[i]). Эти значения накапливаются для каждой гексагональной ячейки и затем обрабатываются в соответствии с reduce_C_function, которое по умолчанию равно numpy.mean. (Если C указано, оно также должно быть одномерной последовательностью такой же длины, как x и y.)

Параметры:	x, y : array or masked array C : array or masked array, optional, default is None gridsize : int or (int, int), optional, default is 100 Количество гексагонов в направлении x, по умолчанию 100. Соответствующее количество гексагонов в направлении y выбирается так, чтобы гексагоны были приблизительно правильными. В качестве альтернативы, gridsize может быть кортежем из двух элементов, определяющих количество гексагонов в направлениях x и y. bins : 'log' or int or sequence, optional, default is None Если None, никакой группировки не применяется; цвет каждого гексагона напрямую соответствует его счету. Если 'log', используется логарифмическая шкала для цветовой карты. Внутри используется \(log_{10}(i+1)\) для определения цвета гексагона. Если целое число, делится количество на указанное количество ячеек и соответственно окрашиваются гексагоны. Если последовательность значений, значения нижней границы используемых ячеек. xscale : {'linear', 'log'}, optional, default is 'linear' Использовать линейную или логарифмическую шкалу по горизонтали. yscale : {'linear', 'log'}, optional, default is 'linear' Использовать линейную или логарифмическую шкалу по вертикали. mincnt : int > 0, optional, default is None Если не None, отображаются только ячейки с количеством точек, превышающим mincnt. marginals : bool, optional, default is False Если marginals равно True, отображается плотность полей как прямоугольники с цветовой шкалой внизу оси x и слева от оси y. extent : scalar, optional, default is None Пределы ячеек. По умолчанию пределы устанавливаются на основе gridsize, x, y, xscale и yscale. Если xscale или yscale установлены в 'log', пределы ожидаются как показатель степени 10. Например, для пределов x 1 и 50 в линейной шкале и пределов y 10 и 1000 в логарифмической шкале, введите (1, 50, 1, 3). Порядок скаляров (слева, справа, снизу, сверху).
Возвращаемое значение:	polycollection Экземпляр PolyCollection; используйте PolyCollection.get_array для получения количества в каждом гексагоне. Если marginals равно True, горизонтальная и вертикальная полосы (оба PolyCollections) будут добавлены к возвращаемому набору как атрибуты hbar и vbar.
Другие параметры:	cmap : object, optional, default is None экземпляр matplotlib.colors.Colormap. Если None, по умолчанию rc image.cmap. norm : object, optional, default is None Используется экземпляр matplotlib.colors.Normalize для масштабирования данных яркости до 0,1. vmin, vmax : scalar, optional, default is None vmin и vmax используются совместно с norm для нормализации данных яркости. Если None, используются минимум и максимум массива цветов C. Обратите внимание, что если вы передаете экземпляр norm, ваши настройки vmin и vmax будут проигнорированы. alpha : scalar between 0 and 1, optional, default is None Значение альфа для наборов. linewidths : scalar, optional, default is None Если None, по умолчанию 1.0. edgecolors : {'face', 'none', None} or color, optional Если 'face' (по умолчанию), рисует края в том же цвете, что и цвет заливки. Если 'none', контур не рисуется; это иногда приводит к некрасивым неокрашенным пикселям между гексагонами. Если None, рисует контуры в стандартном цвете. Если аргумент цвета matplotlib, рисует контуры в указанном цвете.

Примечания

Стандартные описания всех параметров Collection:

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (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	[(Path, Transform) | Patch | 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	число с плавающей точкой или последовательность чисел с плавающей точкой
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).