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 массив-подобный объект

Значения, подлежащие отображению в виде псевдоцветов. Отображение цвета контролируется cmap, norm, vmin и vmax.

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 или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами.

normстрока или Normalize, необязательно

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

Если указано, может быть одним из следующих:

Экземпляр Normalize или один из его подклассов (см. Нормализация цветовых карт).
Имя масштаба, например, "linear", "log", "symlog", "logit" и т.д. Список доступных масштабов см. в matplotlib.scale.get_scale_names(). В этом случае динамически генерируется и создаётся подходящий подкласс Normalize.

vmin, vmaxчисло с плавающей точкой, необязательно

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

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; если они такие же, то выводится предупреждение о устаревании, и последняя строка и столбец C отбрасываются.
'nearest': Каждый узел сетки будет иметь цвет, центрированный на нём, простираясь наполовину между соседними центрами узлов. Размерности X и Y должны быть такими же, как у C.
'gouraud': Каждый четырёхугольник будет затенён по методу Гуро: Цвета вершин (i', j') задаются C[i', j']. Значения цвета в промежуточной области интерполируются из значений углов. Размерности X и Y должны быть такими же, как у C. Когда используется затенение по методу Гуро, edgecolors игнорируется.
'auto': Выбирает 'flat', если размерности X и Y на единицу больше C. Выбирает 'nearest', если размерности одинаковы.

См. Сетки и затенение pcolormesh для более подробного описания.

snapбулево значение, по умолчанию: False

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

rasterizedбулево значение, необязательно

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

Возвращает:

matplotlib.collections.QuadMesh

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

END_OF_DOCUMENT_MARKER

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

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

**kwargs

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

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив с плавающей точкой (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	строка или кортеж или список thereof
`linewidth` или linewidths или lw	число с плавающей точкой или список чисел с плавающей точкой
`mouseover`	bool
`norm`	`Normalize` или строка или None
`offset_transform` или transOffset	неизвестно
`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`

Pcolor Demo

Сетки и затенение pcolormesh

pcolormesh

Размещение цветовых панелей

Подрисунки

Растризация векторной графики

Руководство по ограниченной компоновке

Нормализация цветовых карт

pcolormesh(X, Y, Z)

matplotlib.axes.Axes.pcolormesh

Примечания

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

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