matplotlib.axes.Axes.pcolormesh

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

Параметры:

C2D массив-подобный объект Значения, отображаемые в виде цвета. X, Yмассив-подобный объект, необязательно Координаты углов четырёхугольников для 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 — одномерные массивы или столбцы, они будут расширены до соответствующих двумерных массивов, создавая прямоугольную сетку. cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis') Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения C с цветами. normNormalize, необязательно Экземпляр Normalize масштабирует значения данных до стандартного диапазона цветовой карты [0, 1] для отображения в цветах. По умолчанию диапазон данных отображается в диапазоне цветовой панели с использованием линейного масштабирования. vmin, vmaxfloat, по умолчанию: None Диапазон цветовой панели. Если None, подходящие значения min/max автоматически выбираются экземпляром Normalize (по умолчанию — соответствующие min/max значения C в случае линейного масштабирования). Использование vmin/vmax при заданном norm устарело. edgecolors{'none', None, 'face', цвет, последовательность цветов}, необязательно Цвет границ. По умолчанию 'none'. Возможные значения: 'none' или '': Без границ. None: rcParams["patch.edgecolor"] (по умолчанию: 'black') будет использоваться. Обратите внимание, что в настоящее время rcParams["patch.force_edgecolor"] (по умолчанию: False) должно быть True для работы этого. 'face': Использовать цвет смежной грани. Цвет или последовательность цветов задаёт цвет границ. Форма единственного числа edgecolor работает как псевдоним. alphafloat, по умолчанию: None Значение прозрачности, от 0 (прозрачный) до 1 (непрозрачный). shading{'flat', 'nearest', 'gouraud', 'auto'}, необязательно Стиль заливки четырёхугольника; по умолчанию '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 опускаются. 'nearest': Каждая точка сетки будет иметь цвет, центрированный на ней, простираясь наполовину между соседними центрами сетки. Размерности X и Y должны быть такими же, как у C. 'gouraud': Каждый четырёхугольник будет заливаться методом Гуро: цвета углов (i', j') задаются C[i', j']. Значения цветов области между углами интерполируются из значений углов. Размерности X и Y должны быть такими же, как у C. При использовании заливки Гуро, edgecolors игнорируется. 'auto': Выбирает 'flat', если размерности X и Y на единицу больше, чем у C. Выбирает 'nearest', если размерности одинаковые. См. сетки pcolormesh и заливка для более подробного описания. snapbool, по умолчанию: False Привязывать ли сетку к границам пикселей. rasterized: bool, необязательно Растрировать pcolormesh при рисовании векторной графики. Это может ускорить отрисовку и создать более компактные файлы для больших наборов данных. См. также Растрирование для векторной графики.

Возвращает:

matplotlib.collections.QuadMesh

Другие параметры:

**kwargs Кроме того, разрешены следующие аргументы. Они передаются конструктору QuadMesh: Свойство Описание agg_filter функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, а возвращает массив (m, n, 3) alpha массивоподобный объект, скаляр или None animated bool antialiased или aa или antialiaseds bool или список bool array массив NumPy или None capstyle CapStyle или {'butt', 'projecting', 'round'} clim (vmin: float, vmax: float) clip_box Bbox clip_on bool 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 bool joinstyle JoinStyle или {'miter', 'round', 'bevel'} label объект linestyle или штрихи или стили_линий или ls строка или кортеж или список кортежей linewidth или linewidths или lw число с плавающей точкой или список чисел с плавающей точкой norm Normalize или None offset_position неизвестно offsets (N, 2) или (2,) массивоподобный объект path_effects AbstractPathEffect picker None или bool или float или вызываемый объект pickradius число с плавающей точкой rasterized bool sketch_params (scale: float, length: float, randomness: float) snap bool или None transform Transform url строка urls список строк или None visible bool 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.

Еще одно различие заключается в поддержке затенения Gouraud в pcolormesh, которое недоступно с pcolor.

Примечание

Помимо указанных выше аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, каждый другой аргумент может также быть строкой s, которая интерпретируется как data[s] (если это не вызывает исключение).

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

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

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

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

pcolormesh

Размещение цветовых баров

Подрисунки в фигуре

Растрирование векторной графики

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

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