Spec-Zone.ru › Matplotlib 2.2

matplotlib.axes.Axes.hexbin

Axes.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]

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

Создать диаграмму с гексагональной бинированием по 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, используются min и max массива цвета 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 массив NumPy
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 или штрихи или стили линий ['сплошная' | 'штриховая', 'штрихпунктирная', 'пунктирная' | (смещение, последовательность вкл.-выкл.-штриха) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или linewidths или lw число с плавающей точкой или последовательность чисел с плавающей точкой
norm Normalize
offset_position ['экран' | 'данные']
offsets число с плавающей точкой или последовательность чисел с плавающей точкой
path_effects AbstractPathEffect
picker [None | логическое значение | число с плавающей точкой | вызываемая функция]
pickradius расстояние в точках
rasterized логическое значение или None
sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap логическое значение или None
transform Transform
url строка URL
urls список строк или None
visible логическое значение
zorder число с плавающей точкой

Примечание

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

  • Все аргументы со следующими именами: 'x', 'y'.

© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/2.2.3/api/_as_gen/matplotlib.axes.Axes.hexbin.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API