matplotlib.axes.Axes.pcolormesh

Axes.pcolormesh(self, *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 функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha число с плавающей точкой или None animated булево значение antialiased или aa или antialiaseds булево значение или список булевых значений array массив ndarray capstyle {'butt', 'round', 'projecting'} clim (vmin: число с плавающей точкой, vmax: число с плавающей точкой) clip_box Bbox clip_on булево значение clip_path Объект Patch или (Path, Transform) или None cmap Colormap или строка или None color цвет или список кортежей rgba contains неизвестно edgecolor или ec или edgecolors цвет или список цветов или 'face' facecolor или facecolors или fc цвет или список цветов figure Figure gid строка hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout булево значение 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 или булево значение или вызываемая функция pickradius неизвестно rasterized булево значение или None sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) snap булево значение или None transform Transform url строка urls список строк или None visible булево значение 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.axes.Axes.pcolormesh

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

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

pcolormesh

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

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

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

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

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

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