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)

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

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

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

Параметры:

Параметры:	x, y : массив или маскированный массив C : массив или маскированный массив, необязательно, по умолчанию — None gridsize : int или (int, int), необязательно, по умолчанию — 100 Число гексагонов в направлении x, по умолчанию — 100. Соответствующее число гексагонов в направлении y выбирается таким образом, чтобы гексагоны были приблизительно правильными. В качестве альтернативы, gridsize может быть кортежем из двух элементов, определяющих число гексагонов в направлении x и y. bins : {‘log’} или int или последовательность, необязательно, по умолчанию — None Если None, никакой группировки не выполняется; цвет каждого гексагона непосредственно соответствует его счету. Если ‘log’, используйте логарифмическую шкалу для цветовой карты. Внутренне используется , чтобы определить цвет гексагона. Если целое число, разделите счет на указанное количество ячеек и раскрасьте гексагоны соответственно. Если последовательность значений, значения нижней границы ячеек для использования. xscale : {‘linear’, ‘log’}, необязательно, по умолчанию — ‘linear’ Используйте линейную или логарифмическую шкалу по горизонтальной оси. yscale : {‘linear’, ‘log’}, необязательно, по умолчанию — ‘linear’ Используйте линейную или логарифмическую шкалу по вертикальной оси. mincnt : int > 0, необязательно, по умолчанию — None Если не None, отображаются только ячейки с более чем mincnt точками в ячейке. marginals : bool, необязательно, по умолчанию — False если marginals — True, постройте маргинальную плотность в виде раскрашенных прямоугольников вдоль нижней части оси x и слева от оси y. extent : скаляр, необязательно, по умолчанию — None Пределы ячеек. По умолчанию пределы назначаются на основе gridsize, x, y, xscale и yscale. Если xscale или yscale установлены в ‘log’, пределы ожидают, что это показатель степени 10. Например, для пределов x от 1 до 50 в линейной шкале и пределов y от 10 до 1000 в логарифмической шкале, введите (1, 50, 1, 3). Порядок скаляров (слева, справа, снизу, сверху).
Возвращает:	объект экземпляр `PolyCollection`; используйте `get_array()` на этом экземпляре `PolyCollection`, чтобы получить количество точек в каждом гексагоне. Если marginals — True, горизонтальная и вертикальная полосы (оба PolyCollections) будут присоединены к возвращаемому набору как атрибуты hbar и vbar.
Другие параметры:
	cmap : объект, необязательно, по умолчанию — None экземпляр `matplotlib.colors.Colormap`. Если None, по умолчанию использует значение rc `image.cmap`. norm : объект, необязательно, по умолчанию — None экземпляр `matplotlib.colors.Normalize` используется для масштабирования данных яркости от 0 до 1. vmin, vmax : скаляр, необязательно, по умолчанию — None vmin и vmax используются в сочетании с norm для нормализации данных яркости. Если None, используются минимум и максимум массива цветов C. Обратите внимание, что если вы передаете экземпляр norm, ваши настройки для vmin и vmax будут игнорироваться. alpha : скаляр от 0 до 1, необязательно, по умолчанию — None значение alpha для участков linewidths : скаляр, необязательно, по умолчанию — None Если None, по умолчанию — 1.0. edgecolors : {‘face’, ‘none’, None} или цвет mpl, необязательно, по умолчанию — ‘face’ Если ‘face’, рисует границы в том же цвете, что и цвет заливки. Если ‘none’, границы не рисуются; это иногда может привести к непривлекательным нераскрашенным пикселям между гексагонами. Если None, рисует контуры в стандартном цвете. Если это аргумент цвета matplotlib, рисует контуры в указанном цвете.

x, y : массив или маскированный массив

C : массив или маскированный массив, необязательно, по умолчанию — None

gridsize : int или (int, int), необязательно, по умолчанию — 100

Число гексагонов в направлении x, по умолчанию — 100. Соответствующее число гексагонов в направлении y выбирается таким образом, чтобы гексагоны были приблизительно правильными. В качестве альтернативы, gridsize может быть кортежем из двух элементов, определяющих число гексагонов в направлении x и y.

bins : {‘log’} или int или последовательность, необязательно, по умолчанию — None

Если None, никакой группировки не выполняется; цвет каждого гексагона непосредственно соответствует его счету.

Если ‘log’, используйте логарифмическую шкалу для цветовой карты. Внутренне используется , чтобы определить цвет гексагона.

Если целое число, разделите счет на указанное количество ячеек и раскрасьте гексагоны соответственно.

Если последовательность значений, значения нижней границы ячеек для использования.

xscale : {‘linear’, ‘log’}, необязательно, по умолчанию — ‘linear’

Используйте линейную или логарифмическую шкалу по горизонтальной оси.

yscale : {‘linear’, ‘log’}, необязательно, по умолчанию — ‘linear’

Используйте линейную или логарифмическую шкалу по вертикальной оси.

mincnt : int > 0, необязательно, по умолчанию — None

Если не None, отображаются только ячейки с более чем mincnt точками в ячейке.

marginals : bool, необязательно, по умолчанию — False

если marginals — True, постройте маргинальную плотность в виде раскрашенных прямоугольников вдоль нижней части оси x и слева от оси y.

extent : скаляр, необязательно, по умолчанию — None

Пределы ячеек. По умолчанию пределы назначаются на основе gridsize, x, y, xscale и yscale.

Если xscale или yscale установлены в ‘log’, пределы ожидают, что это показатель степени 10. Например, для пределов x от 1 до 50 в линейной шкале и пределов y от 10 до 1000 в логарифмической шкале, введите (1, 50, 1, 3).

Порядок скаляров (слева, справа, снизу, сверху).

Возвращает:

объект

экземпляр PolyCollection; используйте get_array() на этом экземпляре PolyCollection, чтобы получить количество точек в каждом гексагоне.

Если marginals — True, горизонтальная и вертикальная полосы (оба PolyCollections) будут присоединены к возвращаемому набору как атрибуты hbar и vbar.

Другие параметры:

cmap : объект, необязательно, по умолчанию — None

экземпляр matplotlib.colors.Colormap. Если None, по умолчанию использует значение rc image.cmap.

norm : объект, необязательно, по умолчанию — None

экземпляр matplotlib.colors.Normalize используется для масштабирования данных яркости от 0 до 1.

vmin, vmax : скаляр, необязательно, по умолчанию — None

vmin и vmax используются в сочетании с norm для нормализации данных яркости. Если None, используются минимум и максимум массива цветов C. Обратите внимание, что если вы передаете экземпляр norm, ваши настройки для vmin и vmax будут игнорироваться.

alpha : скаляр от 0 до 1, необязательно, по умолчанию — None

значение alpha для участков

linewidths : скаляр, необязательно, по умолчанию — None

Если None, по умолчанию — 1.0.

edgecolors : {‘face’, ‘none’, None} или цвет mpl, необязательно, по умолчанию — ‘face’

Если ‘face’, рисует границы в том же цвете, что и цвет заливки.

Если ‘none’, границы не рисуются; это иногда может привести к непривлекательным нераскрашенным пикселям между гексагонами.

Если None, рисует контуры в стандартном цвете.

Если это аргумент цвета matplotlib, рисует контуры в указанном цвете.

Примечания

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

Свойство	Описание
`agg_filter`	неизвестно
`alpha`	число с плавающей точкой или None
`animated`	[True \| False]
`antialiased` или antialiaseds	Булево значение или последовательность булевых значений
`array`	неизвестно
`clim`	последовательность из двух чисел с плавающей точкой
`clip_box`	экземпляр `matplotlib.transforms.Bbox`
`clip_on`	[True \| False]
`clip_path`	[ (`Path`, `Transform`) \| `Patch` \| None ]
`cmap`	палитра цветов или зарегистрированное имя палитры
`color`	аргумент цвета matplotlib или последовательность кортежей rgba
`contains`	функция-вызов
`edgecolor` или edgecolors	спецификация цвета matplotlib или последовательность спецификаций
`facecolor` или facecolors	спецификация цвета matplotlib или последовательность спецификаций
`figure`	экземпляр `matplotlib.figure.Figure`
`gid`	строка-идентификатор
`hatch`	[ ‘/’ \| ‘' \| ‘\|’ \| ‘-‘ \| ‘+’ \| ‘x’ \| ‘o’ \| ‘O’ \| ‘.’ \| ‘*’ ]
`label`	строка или любой печатаемый объект с преобразованием ‘%s’
`linestyle` или dashes или linestyles	[‘сплошная’ \| ‘штриховая’, ‘штрихпунктирная’, ‘пунктирная’ \| (смещение, последовательность чередования) \| `'-'` \| `'--'` \| `'-.'` \| `':'` \| `'None'` \| `' '` \| `''`]
`linewidth` или linewidths или lw	число с плавающей точкой или последовательность чисел с плавающей точкой
`norm`	неизвестно
`offset_position`	неизвестно
`offsets`	число с плавающей точкой или последовательность чисел с плавающей точкой
`path_effects`	неизвестно
`picker`	[None\|число с плавающей точкой\|булево значение\|функция-вызов]
`pickradius`	неизвестно
`rasterized`	[True \| False \| None]
`sketch_params`	неизвестно
`snap`	неизвестно
`transform`	экземпляр `Transform`
`url`	строка URL
`urls`	неизвестно
`visible`	[True \| False]
`zorder`	любое число

Примечание

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

Все аргументы с именами ‘x’, ‘y’.