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().

Параметры:

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, подходящие минимальные и максимальные значения автоматически выбираются экземпляром Normalize (по умолчанию — соответственно минимальное и максимальное значения 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 функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha float или None animated bool antialiased или aa или antialiaseds bool или последовательность bool array ndarray capstyle {'butt', 'round', 'projecting'} clim (vmin: float, vmax: float) 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 или float или вызываемый объект pickradius неизвестно rasterized bool или None sketch_params (масштаб: float, длина: float, случайность: 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 с формой (число строк, число столбцов) отображается со значением номера столбца как 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

Примеры графиков в Matplotlib