matplotlib.pyplot.hexbin

matplotlib.pyplot.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 в линейной шкале и пределов 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	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3)
alpha	число с плавающей точкой или None
animated	булево значение
antialiased	булево значение или последовательность булевых значений
array	массив NumPy
capstyle	{'butt', 'round', 'projecting'}
clim	последовательность из двух чисел с плавающей точкой; может быть перезаписана в методах, имеющих параметры vmin и vmax.
clip_box	Bbox
clip_on	булево значение
clip_path	[(Path, Transform) | Patch | None]
cmap	цветовая карта или зарегистрированное имя цветовой карты
color	аргумент цвета matplotlib или последовательность кортежей rgba
contains	вызываемый объект
edgecolor	цвет или последовательность цветов
facecolor	цвет или последовательность цветов
figure	Figure
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	булево значение
joinstyle	{'miter', 'round', 'bevel'}
label	объект
linestyle	{'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...}
linewidth	число с плавающей точкой или последовательность чисел с плавающей точкой
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).