matplotlib.axes.Axes.pcolormesh

Axes.pcolormesh(*args, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, shading=None, antialiased=False, data=None, **kwargs)[source]

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

Вызов:

pcolormesh([X, Y,] C, **kwargs)

X и Y можно использовать для задания углов четырёхугольников.

Подсказка

pcolormesh аналогично pcolor. Она значительно быстрее и предпочтительнее в большинстве случаев. Более подробное обсуждение различий см. в Различия между pcolor() и pcolormesh().

Параметры

C2D массив-подобный объект

Значения, отображаемые в псевдоцветовой шкале.

X, Yмассив-подобный объект, необязательно

Координаты углов четырёхугольников в pcolormesh:

(X[i+1, j], Y[i+1, j])       (X[i+1, j+1], Y[i+1, j+1])
                      +-----+
                      |     |
                      +-----+
    (X[i, j], Y[i, j])       (X[i, j+1], Y[i, j+1])

Обратите внимание, что индекс столбца соответствует координате x, а индекс строки — координате y. Подробности см. в разделе Примечания ниже.

Если shading='flat' размеры X и Y должны быть на единицу больше, чем размеры C, и четырёхугольник окрашивается в соответствии со значением в C[i, j]. Если X, Y и C имеют одинаковые размеры, будет выведено предупреждение, и последняя строка и столбец C будут проигнорированы.

Если shading='nearest' или 'gouraud', размеры X и Y должны быть такими же, как у C (в противном случае будет возбуждено исключение ValueError). В случае 'nearest' цвет C[i, j] находится по центру на (X[i, j], Y[i, j]). В случае 'gouraud', выполняется плавное интерполяционное преобразование между углами четырёхугольника.

Если X и/или Y являются одномерными массивами или столбцами, они будут расширены до соответствующих двумерных массивов, создавая прямоугольную сетку.

cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта отображает значения C в цвета.

normNormalize, необязательно

Экземпляр Normalize масштабирует значения данных до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. По умолчанию диапазон данных сопоставляется с диапазоном цветовой шкалы с использованием линейного масштабирования.

vmin, vmaxчисло, по умолчанию: None

Диапазон цветовой шкалы. Если None, подходящие минимальное и максимальное значения автоматически выбираются экземпляром Normalize (по умолчанию — соответствующие минимальные/максимальные значения C в случае линейного масштабирования). Использование vmin/vmax при заданном norm приводит к ошибке.

edgecolors{'none', None, 'face', цвет, последовательность цветов}, необязательно

Цвет границ. По умолчанию 'none'. Возможные значения:

• 'none' или '': Без границ.
• None: будет использован rcParams["patch.edgecolor"] (по умолчанию: 'black') . Обратите внимание, что в данный момент rcParams["patch.force_edgecolor"] (по умолчанию: False) должно быть True, для этого.
• 'face': Использовать цвет прилежащего графика.
• Цвет или последовательность цветов задаст цвет границ.

Также используется edgecolor в качестве псевдонима.

alphaчисло, по умолчанию: None

Значение смешивания альфа-канала, от 0 (прозрачный) до 1 (непрозрачный).

shading{'flat', 'nearest', 'gouraud', 'auto'}, необязательно

Стиль заливки четырёхугольника; по умолчанию 'flat' или rcParams["pcolor.shading"] (по умолчанию: 'auto'). Возможные значения:

• 'flat': Для каждого четырёхугольника используется твёрдый цвет. Цвет четырёхугольника (i, j), (i+1, j), (i, j+1), (i+1, j+1) задаётся C[i, j]. Размеры X и Y должны быть на единицу больше, чем размеры C; если они такие же, то будет выведено предупреждение о deprecation и последняя строка и столбец C будут отброшены.
• 'nearest': Для каждой точки сетки цвет будет по центру, простираясь на половину расстояния между соседними центрами сетки. Размеры X и Y должны быть такими же, как у C.
• 'gouraud': Каждый четырёхугольник будет затенён методом Гуро: Цвета углов (i', j') задаются C[i', j']. Значения цвета внутри области интерполируются из значений углов. Размеры X и Y должны быть такими же, как у C. При использовании затенения Гуро edgecolors игнорируется.
• 'auto': Выберите 'flat', если размеры X и Y на единицу больше, чем C. Выберите 'nearest', если размеры одинаковы.

См. pcolormesh grids and shading для более подробного описания.

snapbool, по умолчанию: False

Привязать ли сетку к границам пикселей.

rasterizedbool, необязательно

Растрировать pcolormesh при отрисовке векторной графики. Это может ускорить отрисовку и создать меньшие файлы для больших наборов данных. См. также Растрирование для векторной графики.

Возвращает

matplotlib.collections.QuadMesh

Другие параметры

dataиндексируемый объект, необязательно

Если указано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).

**kwargs

Кроме того, разрешены следующие аргументы. Они передаются в конструктор QuadMesh:

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha	массивоподобный объект или скаляр или None
animated	bool
antialiased или aa или antialiaseds	bool или список bool
array	(M, N) массивоподобный объект или массивоподобный объект M*N
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
edgecolor или ec или edgecolors	цвет или список цветов или 'face'
facecolor или facecolors или fc	цвет или список цветов
figure	Figure
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или штрихи или linestyles или ls	строка или кортеж или список кортежей
linewidth или linewidths или lw	число с плавающей точкой или список чисел с плавающей точкой
norm	Normalize или None
offset_transform	Transform
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	число с плавающей точкой

См. также

pcolor

Альтернативная реализация с несколько отличающимися функциями. Подробное обсуждение различий можно найти в Различиях между pcolor() и pcolormesh().

imshow

Если X и Y являются равноудаленными, imshow может быть более быстрой альтернативой.

Примечания

Маскированные массивы

C может быть маскированным массивом. Если C[i, j] замаскирован, соответствующий четырехугольник будет прозрачным. Маскирование X и Y не поддерживается. Используйте pcolor, если вам нужна эта функциональность.

Ориентация сетки

Ориентация сетки следует стандартной матричной конвенции: массив C с формой (nrows, ncolumns) отображается с номером столбца как X и номером строки как Y.

Различия между pcolor() и pcolormesh()

Оба метода используются для создания псевдоцветного графика двумерного массива с использованием четырехугольников.

Основное различие заключается в создаваемом объекте и обработке внутренних данных: в то время как pcolor возвращает PolyCollection, pcolormesh возвращает QuadMesh. Последний более специализирован для данной цели и, следовательно, быстрее. Его следует предпочитать почти во всех случаях.

Также есть небольшое различие в обработке маскированных массивов. Оба pcolor и pcolormesh поддерживают маскированные массивы для C. Однако только pcolor поддерживает маскированные массивы для X и Y. Причина заключается во внутренней обработке маскированных значений. pcolor исключает соответствующие многоугольники из PolyCollection. pcolormesh устанавливает цвет лица замаскированных элементов в прозрачный. Разница видна при использовании edgecolors. В то время как все края рисуются независимо от маскирования в QuadMesh, край между двумя смежными замаскированными четырехугольниками в pcolor не рисуется, так как соответствующие многоугольники не существуют в PolyCollection.

Еще одно отличие заключается в поддержке затенения Гуро в pcolormesh, которое недоступно в pcolor.

Примеры использования matplotlib.axes.Axes.pcolormesh