matplotlib.pyplot.pcolormesh

matplotlib.pyplot.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, vmaxчисло с плавающей точкой, по умолчанию: None Диапазон цветовой шкалы. Если None, соответствующие минимальное и максимальное значения автоматически выбираются экземпляром Normalize (по умолчанию — соответствующие минимальные/максимальные значения C в случае линейного масштабирования). Использование vmin/vmax при заданном norm устарело. edgecolors{'none', None, 'face', цвет, последовательность цветов}, необязательно Цвет границ. По умолчанию 'none'. Возможные значения: 'none' или '': Нет границ. None: rcParams["patch.edgecolor"] (по умолчанию: 'black') будет использоваться. Обратите внимание, что в настоящее время rcParams["patch.force_edgecolor"] (по умолчанию: False) должно быть True для работы этой функции. 'face': Используется цвет смежной грани. Цвет или последовательность цветов установит цвет границ. Также работает сокращенное обозначение edgecolor. alphaчисло с плавающей точкой, по умолчанию: 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, то выводится предупреждение об устаревании, и последняя строка и столбец C отбрасываются. 'nearest': Каждый узел сетки будет иметь цвет, центрированный на нём, простираясь наполовину между соседними центрами узлов. Размерности X и Y должны быть такими же, как у C. 'gouraud': Каждый четырёхугольник будет затенён методом Гуро: цвета углов (i', j') задаются значением C[i', j']. Значения цвета в промежуточной области интерполируются из значений углов. Размерности X и Y должны быть такими же, как у C. При использовании затенения Гуро edgecolors игнорируется. 'auto': Выбрать 'flat', если размерности X и Y на единицу больше, чем C. Выбрать 'nearest', если размерности одинаковые. См. сетки pcolormesh и затенение для более подробного описания. snapбулево значение, по умолчанию: False Привязывать ли сетку к границам пикселей. rasterized: bool, optional Растрировать 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 ndarray или 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 или str или 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 или dashes или linestyles или 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.

Другое различие заключается в поддержке затенения Гуро в pcolormesh, которое недоступно с pcolor.

Примечание

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

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

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

Примеры графиков в Matplotlib