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=<function mean>, 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', используется логарифмическая шкала для цветовой карты. Внутренне, используется для определения цвета гексагона. Если целое число, делит счеты на указанное число бинов и окрашивает гексагоны соответствующим образом. Если последовательность значений, значения нижней границы используемых бинов. 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 в шкале 'linear' и пределов y от 10 до 1000 в шкале 'log' введите (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	float или None
animated	bool
antialiased	bool или последовательность bool
array	массив ndarray
capstyle	{'butt', 'round', 'projecting'}
clim	последовательность из 2 чисел с плавающей точкой; может быть перезаписана в методах, имеющих параметры vmin и vmax.
clip_box	Bbox
clip_on	bool
clip_path	[(Path, Transform) | Patch | None]
cmap	колористическая карта или зарегистрированное имя цветовой карты
color	matplotlib цветовой аргумент или последовательность кортежей rgba
contains	вызываемый объект
edgecolor	цвет или последовательность цветов
facecolor	цвет или последовательность цветов
figure	Figure
gid	строка str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	{'miter', 'round', 'bevel'}
label	объект
linestyle	{'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...}
linewidth	число с плавающей точкой или последовательность чисел с плавающей точкой
norm	Normalize
offset_position	{'screen', 'data'}
offsets	число с плавающей точкой или последовательность чисел с плавающей точкой
path_effects	AbstractPathEffect
picker	None или bool или число с плавающей точкой или вызываемый объект
pickradius	неизвестно
rasterized	bool или None
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	bool или None
transform	Transform
url	строка str
urls	Список[строка] или None
visible	bool
zorder	число с плавающей точкой

Примечание

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

• Все аргументы с именами: 'x', 'y'.

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