matplotlib.axes.Axes.pcolormesh

Axes.pcolormesh(*args, data=None, **kwargs) [source]

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

Вызов функции:

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

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

Примечание

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

Параметры:

C : array_like Массив 2-мерных скалярных значений. Значения будут отображаться в цветовой карте. 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 являются 1-мерными массивами или столбцами, они будут расширены до необходимых 2-мерных массивов, создавая прямоугольную сетку. cmap : str or Colormap, optional Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения C с цветами. По умолчанию используется rcParams["image.cmap"]. norm : Normalize, optional Экземпляр Normalize масштабирует значения данных в диапазон канонической цветовой карты [0, 1] для сопоставления с цветами. По умолчанию диапазон данных отображается в диапазон цветовой шкалы с использованием линейного масштабирования. vmin, vmax : scalar, optional, default: None Диапазон значений цветовой шкалы. Если None, подходящие минимальное и максимальное значения автоматически выбираются экземпляром Normalize (по умолчанию используются минимальное и максимальное значения 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 или antialiaseds Булево значение или последовательность булевых значений array массив ndarray capstyle неизвестно clim последовательность длиной 2 из чисел с плавающей точкой; может быть переопределён в методах, имеющих параметры vmin и vmax clip_box экземпляр Bbox clip_on bool 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 или dashes или linestyles ['сплошная' | 'штриховая', 'штрихпунктирная', 'пунктирная' | (смещение, последовательность включения-выключения) | '-' | '--' | '-.' | ':' | 'None' | ' ' | ''] linewidth или linewidths или lw число с плавающей точкой или последовательность чисел с плавающей точкой norm Normalize offset_position [ 'экран' | 'данные' ] offsets число с плавающей точкой или последовательность чисел с плавающей точкой path_effects AbstractPathEffect picker [None | bool | float | вызываемая функция] pickradius расстояние в точках rasterized bool или None sketch_params (масштаб: float, длина: float, случайность: float) snap bool или None transform Transform url строка-url urls Список [str] или 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>]:

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

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

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

pcolormesh

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