matplotlib.pyplot.pcolormesh

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

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

Вызов:

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

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

Примечание

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

Параметры:

C : array_like Массив 2-D скалярных значений. Значения будут отображаться в цветовой карте. X, Y : array_like, optional Координаты углов четырёхугольников. Четырёхугольник для C[i,j] имеет углы: (X[i+1, j], Y[i+1, j]) (X[i+1, j+1], Y[i+1, j+1]) +--------+ | C[i,j] | +--------+ (X[i, j], Y[i, j]) (X[i, j+1], Y[i, j+1]), Обратите внимание, что индекс столбца соответствует координате x, а индекс строки — y. Подробности см. в разделе Примечания ниже. Размеры X и Y должны быть на единицу больше, чем размеры C. В качестве альтернативы, X, Y и C могут иметь одинаковые размеры, в этом случае последняя строка и столбец C будут игнорироваться. Если X и/или Y являются одномерными массивами или столбцами, они будут расширены в необходимые двумерные массивы, создавая прямоугольную сетку. cmap : str or Colormap, optional Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта отображает значения C в цвета. По умолчанию используется rcParams["image.cmap"]. norm : Normalize, optional Экземпляр Normalize, который масштабирует значения данных до канонического диапазона цветовой карты [0, 1] для сопоставления с цветами. По умолчанию диапазон данных сопоставляется с диапазоном цветовой шкалы с использованием линейного масштабирования. vmin, vmax : scalar, optional, default: None Диапазон цветовой шкалы. Если None, подходящие значения min/max автоматически выбираются экземпляром Normalize (по умолчанию — соответствующие значения min/max C в случае линейного масштабирования). edgecolors : {'none', None, 'face', color, color sequence}, optional Цвет границ. По умолчанию 'none'. Возможные значения: 'none' или '': Без границы. None: Будет использоваться rcParams["patch.edgecolor"]. Обратите внимание, что в настоящее время rcParams["patch.force_edgecolor"] должен быть True для работы этой функции. 'face': Использовать цвет соседней грани. Цвета mpl или последовательность цветов задают цвет границы. Форма единственного слова edgecolor работает как псевдоним. alpha : scalar, optional, default: None Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). shading : {'flat', 'gouraud'}, optional Стиль заливки, Возможные значения: 'flat': Для каждого четырёхугольника используется твёрдый цвет. Цвет четырёхугольника (i, j), (i+1, j), (i, j+1), (i+1, j+1) задаётся C[i,j]. 'gouraud': Каждый четырёхугольник будет затенён методом Гуро: цвета углов (i', j') задаются C[i',j']. Значения цветов внутри области интерполируются из значений углов. При использовании затенения Гуро, edgecolors игнорируется. snap : bool, optional, default: False Привязывать ли сетку к границам пикселей.

Возвращает:

mesh : matplotlib.collections.QuadMesh

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

**kwargs Кроме того, разрешены следующие аргументы. Они передаются в конструктор QuadMesh: Свойство Описание agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha float или None animated bool antialiased bool или последовательность bool array массив ndarray capstyle {'butt', 'round', 'projecting'} clim последовательность из 2 чисел с плавающей точкой; может быть переопределён в методах, имеющих vmin и vmax kwargs. clip_box Bbox clip_on bool clip_path [(Path, Transform) | Patch | None] cmap колорирование или зарегистрированное имя колорирования color аргумент цвета matplotlib или последовательность кортежей rgba contains вызываемый объект edgecolor цвет или последовательность цветов facecolor цвет или последовательность цветов figure Figure gid строка hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout bool joinstyle {'miter', 'round', 'bevel'} label объект linestyle {'-', '--', '-.', ':', '', (смещение, последовательность включений-выключений), ...} linewidth float или последовательность чисел с плавающей точкой norm Normalize offset_position {'screen', 'data'} offsets число с плавающей точкой или последовательность чисел с плавающей точкой path_effects AbstractPathEffect picker None или bool или float или вызываемый объект pickradius неизвестно rasterized bool или None sketch_params (масштаб: float, длина: float, случайность: float) snap bool или None transform Transform url строка urls Список строк или None visible bool zorder float

См. также

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.

Примечание

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

• Все позиционные и все ключевые аргументы.

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

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

Демонстрация pcolor

pcolormesh

Демонстрация QuadMesh