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, hold=None, data=None, **kwargs) [source]

Создаёт диаграмму с гексагональной бининговкой.

Создаёт диаграмму с гексагональной бининговкой для 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 : 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`; используйте `get_array()` на этом `PolyCollection` для получения количества в каждом гексагоне. Если 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` или antialiaseds	Булево значение или последовательность булевых значений
`array`	массив ndarray
`capstyle`	неизвестно
`clim`	последовательность из двух чисел с плавающей точкой; может быть переопределено в методах, имеющих `vmin` и `vmax` аргументы.
`clip_box`	экземпляр `Bbox`
`clip_on`	булево значение
`clip_path`	[(`Path`, `Transform`) \| `Patch` \| None]
`cmap`	колористическая карта или зарегистрированное имя колористической карты
`color`	аргумент цвета matplotlib или последовательность кортежей rgba
`contains`	вызываемая функция
`edgecolor` или edgecolors	спецификация цвета matplotlib или последовательность спецификаций
`facecolor` или facecolors	спецификация цвета matplotlib или последовательность спецификаций
`figure`	экземпляр `Figure`
`gid`	строка идентификатора
`hatch`	['/' \| '\' \| '\|' \| '-' \| '+' \| 'x' \| 'o' \| 'O' \| '.' \| '*']
`joinstyle`	неизвестно
`label`	объект
`linestyle` или штрихи или linestyles	['сплошная' \| 'пунктирная', 'штрихпунктирная', 'точковая' \| (смещение, последовательность вкл-выкл-штрихов) \| `'-'` \| `'--'` \| `'-.'` \| `':'` \| `'None'` \| `' '` \| `''`]
`linewidth` или linewidths или lw	число с плавающей точкой или последовательность чисел с плавающей точкой
`norm`	`Normalize`
`offset_position`	[ 'экран' \| 'данные' ]
`offsets`	число с плавающей точкой или последовательность чисел с плавающей точкой
`path_effects`	`AbstractPathEffect`
`picker`	[None \| bool \| число с плавающей точкой \| вызываемая функция]
`pickradius`	расстояние в точках
`rasterized`	булево значение или None
`sketch_params`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`snap`	булево значение или None
`transform`	`Transform`
`url`	строка URL
`urls`	Список строк или None
`visible`	булево значение
`zorder`	число с плавающей точкой

Примечание

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

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