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)

Построение гексагональной бинограммы.

Построение гексагональной бинограммы для 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 : целое число или кортеж из целых чисел, необязательный, по умолчанию 100 Число гексагонов в направлении x, по умолчанию 100. Соответствующее число гексагонов в направлении y выбирается таким образом, чтобы гексагоны были приблизительно правильными. В качестве альтернативы, gridsize может быть кортежем из двух элементов, задающим число гексагонов в направлении x и направлении y. bins : {‘log’} или целое число или последовательность, необязательный, по умолчанию None Если None, бинирование не применяется; цвет каждого гексагона напрямую соответствует его количеству. Если ‘log’, используется логарифмическая шкала для цветовой карты. Внутренне, используется для определения цвета гексагона. Если целое число, значения делятся на указанное число бинов, и гексагоны раскрашиваются соответственно. Если последовательность значений, значения нижней границы используемых бинов. xscale : {‘linear’, ‘log’}, необязательный, по умолчанию ‘linear’ Используется линейная или логарифмическая шкала по горизонтали. yscale : {‘linear’, ‘log’}, необязательный, по умолчанию ‘linear’ Используется линейная или логарифмическая шкала по вертикали. mincnt : целое число > 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()` для получения количества в каждом гексагоне. Если 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 значение альфа для заливки linewidths : скаляр, необязательный, по умолчанию None Если None, по умолчанию 1.0. edgecolors : {‘face’, ‘none’, None} или цвет matplotlib, необязательный, по умолчанию ‘face’ Если ‘face’, линии рисуются в том же цвете, что и заливка. Если ‘none’, линии не рисуются; это иногда может привести к некрасивым некрашеным пикселям между гексагонами. Если None, контуры рисуются в стандартном цвете. Если аргумент matplotlib цвета, контуры рисуются в указанном цвете.

x, y : массив или массив с пропусками

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

gridsize : целое число или кортеж из целых чисел, необязательный, по умолчанию 100

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

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

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

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

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

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

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

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

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

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

mincnt : целое число > 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() для получения количества в каждом гексагоне.

Если 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

значение альфа для заливки

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

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

edgecolors : {‘face’, ‘none’, None} или цвет matplotlib, необязательный, по умолчанию ‘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’.