matplotlib.axes.Axes.pcolormesh

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

Параметры:

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, подходящие значения min/max автоматически выбираются экземпляром Normalize (по умолчанию — соответствующие min/max значения 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 Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). shading : {'flat', 'gouraud'}, optional Стиль заливки. Возможные значения: 'flat': Для каждого четырёхугольника используется сплошной цвет. Цвет четырёхугольника (i, j), (i+1, j), (i, j+1), (i+1, j+1) задаётся значением C[i,j]. 'gouraud': Каждый четырёхугольник будет затенён по методу Gouraud: Цвета вершин (i', j') задаются значением C[i',j']. Значения цвета области между вершинами интерполируются из значений вершин. При использовании затенения Gouraud, 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 булево значение или последовательность булевых значений array массив ndarray capstyle {'butt', 'round', 'projecting'} clim последовательность из двух чисел с плавающей запятой; может быть переопределено в методах, имеющих аргументы vmin и vmax clip_box Bbox clip_on булево значение clip_path [(Path, Transform) | Patch | None] cmap палитра цветов или зарегистрированное имя палитры color аргумент цвета matplotlib или последовательность кортежей rgba contains вызываемый объект edgecolor цвет или последовательность цветов facecolor цвет или последовательность цветов figure Figure gid строка hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout булево значение joinstyle {'miter', 'round', 'bevel'} label объект linestyle {'-', '--', '-.', ':', '', (смещение, последовательность включений/выключений), ...} linewidth число с плавающей запятой или последовательность чисел с плавающей запятой 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