matplotlib.pyplot.pcolormesh

matplotlib.pyplot.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-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 являются одномерными массивами или столбцами, они будут расширены до необходимых 2-D массивов, создавая прямоугольную сетку. 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 Значение альфа-смешивания, от 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.pyplot.pcolormesh

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

pcolormesh

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