matplotlib.pyplot.pcolormesh

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

Параметры:

Carray-like Массив скалярных 2-мерных значений. Значения будут отображены в цветовой шкале. X, Yarray-like, optional Координаты углов четырехугольников в 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 являются одномерными массивами или столбцами, они будут расширены до соответствующих двумерных массивов, создавая прямоугольную сетку. cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis') Экземпляр Colormap или имя зарегистрированной цветовой карты. Цветовая карта отображает значения C в цвета. normNormalize, optional Экземпляр Normalize масштабирует значения данных до канонического диапазона цветовой карты [0, 1] для отображения в цветах. По умолчанию диапазон данных отображается в диапазоне цветовой панели с линейным масштабированием. vmin, vmaxfloat, default: None Диапазон цветовой панели. Если None, соответствующие минимальные/максимальные значения выбираются автоматически экземпляром Normalize (по умолчанию - соответствующие минимальные/максимальные значения C в случае линейного масштабирования). Использование vmin/vmax при заданном norm устарело. edgecolors{'none', None, 'face', color, color sequence}, optional Цвет границ. По умолчанию 'none'. Возможные значения: 'none' или '': Нет границ. None: rcParams["patch.edgecolor"] (по умолчанию: 'black') будет использоваться. Обратите внимание, что в настоящее время rcParams["patch.force_edgecolor"] (по умолчанию: False) должно быть True для работы. 'face': Использовать цвет прилегающей грани. Цвет или последовательность цветов установит цвет границ. Сингулярная форма edgecolor работает как псевдоним. alphafloat, default: None Значение альфа-смешивания, между 0 (прозрачный) и 1 (непрозрачный). shading{'flat', 'nearest', 'gouraud', 'auto'}, optional Стиль заполнения четырехугольника; по умолчанию 'flat' или rcParams["pcolor.shading"] (по умолчанию: 'flat'). Возможные значения: 'flat': Для каждого четырехугольника используется твёрдый цвет. Цвет четырехугольника (i, j), (i+1, j), (i, j+1), (i+1, j+1) задаётся C[i, j]. Размерности X и Y должны быть на единицу больше, чем у C; если они такие же, как у C, то выводится предупреждение об устаревании, и последняя строка и столбец C отбрасываются. 'nearest': Каждый узел сетки будет иметь цвет, центрированный на нём, простираясь наполовину между соседними центрами узлов. Размерности X и Y должны быть такими же, как у C. 'gouraud': Каждый четырехугольник будет затенён по методу Гуро: цвета углов (i', j') задаются C[i', j']. Значения цветов в промежутке интерполируются из значений углов. Размерности X и Y должны быть такими же, как у C. Когда используется затенение Гуро, edgecolors игнорируется. 'auto': Выберите 'flat', если размерности X и Y на единицу больше C. Выберите 'nearest', если размерности одинаковые. См. сетки и затенение pcolormesh для более подробного описания. snapbool, default: False Необходимо ли привязать сетку к границам пикселей.

Возвращает:

matplotlib.collections.QuadMesh

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

**kwargs Кроме того, разрешены следующие аргументы. Они передаются конструктору QuadMesh: Свойство Описание agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha число с плавающей точкой или 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 Colormap или str или None 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 или None offset_position неизвестно offsets массивоподобный объект (N, 2) или (2,) path_effects AbstractPathEffect picker None или bool или вызываемый объект pickradius неизвестно rasterized bool или None 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.

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, каждый другой аргумент также может быть строкой s, которая интерпретируется как data[s] (если это не вызывает исключение).

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

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

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

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

pcolormesh

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

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