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

Параметры:

C : array_like Массив 2-мерных скалярных значений. Значения будут отображаться в цветовой шкале. 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': Используется цвет смежной грани. Цвета matplotlib или последовательность цветов будут установлены для цвета границы. Одиночная форма edgecolor работает как псевдоним. alpha : scalar, optional, default: None Значение прозрачности (alpha), от 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 или aa или antialiaseds логическое значение или последовательность логических значений array массив NumPy capstyle {'butt', 'round', 'projecting'} clim последовательность из двух чисел с плавающей точкой; может быть переопределена в методах, имеющих параметры vmin и vmax clip_box Bbox clip_on логическое значение clip_path [(Path, Transform) | Patch | None] cmap цветовая карта или зарегистрированное имя цветовой карты 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 offset_position {'screen', 'data'} offsets число с плавающей точкой или последовательность чисел с плавающей точкой 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 задан, следующие аргументы заменяются на data[<arg>]:

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

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

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

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

pcolormesh

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

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