matplotlib.pyplot.pcolormesh

matplotlib.pyplot.pcolormesh(*args, **kwargs) [source]

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

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

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

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

Примечание

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

Параметры:

C : array_like Скалярный массив 2-D. Значения будут отображаться с помощью цветовой карты. 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 являются одномерными массивами или столбцами, они будут расширены по мере необходимости в соответствующие двумерные массивы, образуя прямоугольную сетку. 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 функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3) alpha число с плавающей точкой или None animated булево значение antialiased или antialiaseds булево значение или последовательность булевых значений array массив ndarray capstyle неизвестно clim последовательность из двух чисел с плавающей точкой; может быть переопределён в методах, имеющих параметры vmin и vmax. clip_box экземпляр Bbox clip_on булево значение 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 или штрихи или стили линий ['сплошная' | 'штриховая', 'штрихпунктирная', 'пунктирная' | (смещение, последовательность чередования) | '-' | '--' | '-.' | ':' | 'None' | ' ' | ''] linewidth или linewidths или lw число с плавающей точкой или последовательность чисел с плавающей точкой norm Normalize offset_position ['экран' | 'данные'] offsets число с плавающей точкой или последовательность чисел с плавающей точкой path_effects AbstractPathEffect picker [None | булево | число с плавающей точкой | вызываемая функция] pickradius расстояние в точках rasterized булево или None sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) snap булево или None transform Transform url строка 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 задан, следующие аргументы заменяются на data[<arg>]:

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

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

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

pcolormesh

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