matplotlib.axes.Axes.pcolormesh

Axes.pcolormesh(self, *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().

Параметры:

Carray-like Массив скалярных значений 2-х мерный. Значения будут сопоставлены с цветами. X, Yarray-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 являются одномерными массивами или столбцами, они будут расширены до соответствующих двумерных массивов, создавая прямоугольную сетку. cmapstr or Colormap, optional Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения C с цветами. По умолчанию используется rcParams["image.cmap"] (по умолчанию: 'viridis'). normNormalize, optional Экземпляр Normalize масштабирует значения данных до канонического диапазона цветовой карты [0, 1] для сопоставления с цветами. По умолчанию, диапазон данных сопоставляется с диапазоном цветовой полосы с помощью линейного масштабирования. vmin, vmaxscalar, optional, default: None Диапазон цветовой полосы. Если None, подходящие значения min/max автоматически выбираются экземпляром Normalize (по умолчанию — соответствующие значения min/max C в случае линейного масштабирования по умолчанию). edgecolors{'none', None, 'face', color, color sequence}, optional Цвет границ. По умолчанию 'none'. Возможные значения: 'none' или '': Без границ. None: Будет использован rcParams["patch.edgecolor"] (по умолчанию: 'black'). Обратите внимание, что в настоящее время rcParams["patch.force_edgecolor"] (по умолчанию: False) должен быть True для работы. 'face': Использовать цвет смежной грани. Цвет или последовательность цветов установят цвет границ. Форма единственного числа edgecolor работает как псевдоним. alphascalar, 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 игнорируется. snapbool, optional, default: False Принудительно ли привязывать сетку к границам пикселей.

Возвращает:

meshmatplotlib.collections.QuadMesh

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

**kwargs Кроме того, разрешены следующие аргументы. Они передаются конструктору QuadMesh: Свойство Описание agg_filter функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi, и возвращает (m, n, 3) массив alpha число с плавающей точкой или None animated bool antialiased или aa или antialiaseds bool или последовательность bool array ndarray capstyle {'butt', 'round', 'projecting'} clim (vmin: число с плавающей точкой, vmax: число с плавающей точкой) clip_box Bbox clip_on bool clip_path Объект Patch или (Path, Transform) или None cmap карта цветов или зарегистрированное имя карты цветов color цвет или последовательность кортежей rgba contains вызываемая функция edgecolor или ec или edgecolors цвет или последовательность цветов или 'face' facecolor или facecolors или fc цвет или последовательность цветов figure Figure gid строка hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout bool joinstyle {'miter', 'round', 'bevel'} label объект linestyle или dashes или linestyles или ls {'-', '--', '-.', ':', '', (смещение, последовательность включений/выключений), ...} linewidth или linewidths или lw число с плавающей точкой или последовательность чисел с плавающей точкой norm Normalize offset_position {'screen', 'data'} offsets массивоподобный объект (N, 2) или (2,) path_effects AbstractPathEffect picker None или bool или число с плавающей точкой или вызываемая функция pickradius неизвестно rasterized bool или None sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) 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.

Примечание

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

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

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

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

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

pcolormesh

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

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

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

Нормализация цветовой карты двухсторонней

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

Создание цветовых карт в Matplotlib

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