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 0x7fba59dfc310>, 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, optional Если задано, эти значения накапливаются в ячейках. В противном случае каждая точка имеет значение 1. Должно иметь такую же длину, как x и y. gridsizeint or (int, int), default: 100 Если целое число, количество шестиугольников в направлении x. Количество шестиугольников в направлении y выбирается таким образом, чтобы шестиугольники были приблизительно правильными. В качестве альтернативы, если кортеж (nx, ny), количество шестиугольников в направлениях x и y. bins'log' or int or sequence, default: None Дискретизация значений шестиугольника. Если None, никакое разбиение по ячейкам не применяется; цвет каждого шестиугольника напрямую соответствует его счётчику. Если 'log', используйте логарифмическую шкалу для цветовой карты. Внутри используется \(log_{10}(i+1)\) для определения цвета шестиугольника. Это эквивалентно norm=LogNorm(). Если целое число, разделите счётчики на указанное количество ячеек и раскрасьте шестиугольники соответствующим образом. Если последовательность значений, значения нижней границы ячеек, которые будут использоваться. xscale{'linear', 'log'}, default: 'linear' Использовать линейную или логарифмическую шкалу по оси абсцисс. yscale{'linear', 'log'}, default: 'linear' Использовать линейную или логарифмическую шкалу по оси ординат. mincntint > 0, default: None Если не None, отображаются только ячейки с количеством точек, превышающим mincnt. marginalsbool, default: False Если marginals равно True, постройте предельную плотность как раскрашенные прямоугольники по нижней части оси абсцисс и слева от оси ординат. extentfloat, default: 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, горизонтальная и вертикальная полосы (обе PolyCollections) будут добавлены к возвращаемому набору как атрибуты hbar и vbar.
Другие параметры:	cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis') Экземпляр Colormap или зарегистрированное имя цветовой карты, используемое для сопоставления значений ячейки с цветами. normNormalize, optional Экземпляр Normalize масштабирует значения ячеек до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. По умолчанию диапазон данных сопоставляется с диапазоном цветовой шкалы с использованием линейного масштабирования. vmin, vmaxfloat, default: None Диапазон цветовой шкалы. Если None, подходящие минимальные/максимальные значения автоматически выбираются экземпляром Normalize (по умолчанию — соответствующие минимальные/максимальные значения ячеек в случае линейного масштабирования). Использование vmin/vmax устарело, когда задан norm. alphafloat between 0 and 1, optional Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). linewidthsfloat, default: None Если None, по умолчанию равно 1.0. edgecolors{'face', 'none', None} or color, default: 'face' Цвет краёв шестиугольников. Возможные значения: 'face': Отображать края тем же цветом, что и цвет заливки. 'none': Края не отображаются. Иногда это может привести к некрасивым неокрашенным пикселям между шестиугольниками. None: Отображать контуры в стандартном цвете. Явный цвет. reduce_C_functioncallable, default: numpy.mean Функция для агрегации C внутри ячеек. Она игнорируется, если C не задано. Она должна иметь сигнатуру: def reduce_C_function(C: array) -> float Обычно используемые функции: numpy.mean: среднее значение точек numpy.sum: интеграл значений точек numpy.max: значение, взятое из самой большой точки **kwargsPolyCollection properties

Все остальные ключевые аргументы передаются в PolyCollection: Свойство Описание agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив float (m, n, 3) alpha число с плавающей точкой или None animated логическое значение antialiased или aa или antialiaseds логическое значение или список логических значений array массив ndarray capstyle {'butt', 'round', 'projecting'} clim (vmin: число с плавающей точкой, vmax: число с плавающей точкой) clip_box Bbox clip_on логическое значение 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 логическое значение 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 или логическое значение или вызываемая функция pickradius неизвестно rasterized логическое значение или None sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) snap логическое значение или None transform Transform url строка urls список строк или None visible логическое значение zorder число с плавающей точкой

Примечания

Примечание

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

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

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