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]

Построение 2D-диаграммы шестиугольных ячеек для точек x, y.

Если C равно None, значение шестиугольника определяется количеством точек в шестиугольнике. В противном случае, C задаёт значения в координате (x[i], y[i]). Для каждого шестиугольника эти значения усредняются с помощью reduce_C_function.

Параметры:	x, yarray-like Положения данных. x и y должны иметь одинаковую длину. Carray-like, необязательно Если задано, эти значения накапливаются в ячейках. В противном случае, каждой точке присваивается значение 1. Должно иметь одинаковую длину с x и y. gridsizeint или (int, int), по умолчанию: 100 Если целое число, количество шестиугольников в направлении x. Количество шестиугольников в направлении y выбирается так, чтобы шестиугольники были приблизительно правильными. В качестве альтернативы, если кортеж (nx, ny), количество шестиугольников в направлении x и y. bins'log' или int или последовательность, по умолчанию: None Дискретизация значений шестиугольника. Если None, никакой дискретизации не применяется; цвет каждого шестиугольника напрямую соответствует его количеству. Если 'log', используется логарифмическая шкала для цветовой карты. Внутри используется \(log_{10}(i+1)\) для определения цвета шестиугольника. Это эквивалентно norm=LogNorm(). Если целое число, делится количество точек в указанном количестве ячеек и окрашиваются шестиугольники соответствующим образом. Если последовательность значений, значения нижней границы ячеек, которые будут использоваться. xscale{'linear', 'log'}, по умолчанию: 'linear' Используйте линейную или логарифмическую (log10) шкалу по горизонтальной оси. yscale{'linear', 'log'}, по умолчанию: 'linear' Используйте линейную или логарифмическую (log10) шкалу по вертикальной оси. mincntint > 0, по умолчанию: None Если не None, отображаются только ячейки с более чем mincnt точками в ячейке. marginalsbool, по умолчанию: False Если marginals равно True, строятся маргинальные плотности в виде цветных прямоугольников вдоль нижней части оси x и слева от оси y. extentfloat, по умолчанию: None Пределы ячеек. По умолчанию пределы устанавливаются на основе gridsize, x, y, xscale и yscale. Если xscale или yscale установлено в 'log', пределы ожидаются как показатель степени 10. Например, для пределов x от 1 до 50 в 'linear' шкале и пределов y от 10 до 1000 в 'log' шкале, введите (1, 50, 1, 3). Порядок скаляров (левый, правый, нижний, верхний).
Возвращаемое значение:	PolyCollection А PolyCollection определяющая шестиугольные ячейки. PolyCollection.get_offsets содержит Mx2 массив, содержащий x, y координаты центров M шестиугольников. PolyCollection.get_array содержит значения M шестиугольников. Если marginals равно True, горизонтальная и вертикальная полосы (оба PolyCollection) будут присоединены к возвращаемой коллекции как атрибуты hbar и vbar.
Другие параметры:	cmapstr или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis') Объект Colormap или зарегистрированное имя цветовой карты, используемое для сопоставления значений ячеек с цветами. normNormalize, необязательно Объект Normalize масштабирует значения ячеек в диапазон стандартной цветовой карты [0, 1] для сопоставления с цветами. По умолчанию диапазон данных масштабируется к диапазону цветовой шкалы с использованием линейного масштабирования. vmin, vmaxfloat, по умолчанию: None Диапазон цветовой шкалы. Если None, подходящие значения min/max автоматически выбираются объектом Normalize (по умолчанию это соответствующие минимальные/максимальные значения ячеек в случае линейного масштабирования). Использование vmin/vmax устарело, когда задан norm. alphaзначение от 0 до 1, необязательно Значение смешивания alpha, от 0 (прозрачный) до 1 (непрозрачный). linewidthsfloat, по умолчанию: None Если None, по умолчанию 1.0. edgecolors{'face', 'none', None} или цвет, по умолчанию: 'face' Цвет границ шестиугольника. Возможные значения: 'face': Рисует грани тем же цветом, что и заливка. 'none': Границы не рисуются. Это иногда приводит к некрасивым неокрашенным пикселям между шестиугольниками. None: Рисует контуры в стандартном цвете. Явное значение цвета. reduce_C_functioncallable, по умолчанию: numpy.mean Функция для агрегирования C внутри ячеек. Игнорируется, если C не задано. Должна иметь сигнатуру: def reduce_C_function(C: array) -> float Общепринятые функции: numpy.mean: среднее арифметическое значений. numpy.sum: интеграл значений точек. numpy.amax: значение максимальной точки. **kwargsPolyCollection свойства

Все остальные ключевые аргументы передаются в PolyCollection: Свойство Описание agg_filter функция фильтра, которая принимает массив (m, n, 3) с плавающей точкой и значение dpi, и возвращает массив (m, n, 3) alpha подобный массиву объект или скаляр или None animated bool antialiased или aa или antialiaseds bool или список bool array массив NumPy или None capstyle CapStyle или {'butt', 'projecting', 'round'} clim (vmin: float, vmax: float) clip_box Bbox clip_on bool clip_path Объект Patch или (Path, Transform) или None cmap Colormap или строка или None color цвет или список кортежей rgba contains неизвестно edgecolor или ec или edgecolors цвет или список цветов или 'face' facecolor или facecolors или fc цвет или список цветов figure Figure gid строка hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout bool joinstyle JoinStyle или {'miter', 'round', 'bevel'} label объект linestyle или dashes или linestyles или ls строка или кортеж или список кортежей linewidth или linewidths или lw число с плавающей точкой или список чисел с плавающей точкой norm Normalize или None offset_position неизвестно offsets массив (N, 2) или (2,) path_effects AbstractPathEffect picker None или bool или число с плавающей точкой или вызываемая функция pickradius число с плавающей точкой rasterized bool sketch_params (scale: float, length: float, randomness: float) snap bool или None transform Transform url строка urls список строк или None visible bool zorder число с плавающей точкой

Примечания

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не вызывает исключение): x, y, C.

Объекты, передаваемые как data, должны поддерживать доступ по элементам (data[s]) и проверку на членство (s in data).

Примеры использования matplotlib.pyplot.hexbin