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 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`	float или None
`animated`	bool
`antialiased` или aa или antialiaseds	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`	цвет или последовательность кортежей rgba
`contains`	вызываемый объект
`edgecolor` или ec или edgecolors	цвет или последовательность цветов или 'face'
`facecolor` или facecolors или fc	цвет или последовательность цветов
`figure`	`Figure`
`gid`	строка str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`in_layout`	bool
`joinstyle`	{'miter', 'round', 'bevel'}
`label`	объект object
`linestyle` или dashes или linestyles или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включений-выключений), ...}
`linewidth` или linewidths или lw	число с плавающей точкой или последовательность чисел с плавающей точкой
`norm`	`Normalize`
`offset_position`	{'экран', 'данные'}
`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).