matplotlib.axes.Axes.pcolorfast
-
Axes.pcolorfast(*args, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, data=None, **kwargs)[source] -
Создание псевдоцветного графика с нерегулярной прямоугольной сеткой.
Вызов:
ax.pcolorfast([X, Y], C, /, **kwargs)
Этот метод похож на
pcolorиpcolormesh. Он предназначен для обеспечения самого быстрого графического отображения типа pcolor с использованием бэкэнда Agg. Для этого он использует разные алгоритмы внутри в зависимости от сложности входной сетки (регулярная прямоугольная, нерегулярная прямоугольная или произвольная четырехугольная).Предупреждение
Этот метод является экспериментальным. По сравнению с
pcolorилиpcolormeshу него есть некоторые ограничения:- Он поддерживает только плоское затенение (без контуров)
- Он не поддерживает логарифмическую шкалу осей.
- У него нет обертки pyplot.
Параметры: - Carray-like
-
Данные изображения. Поддерживаемые формы массива:
- (M, N): изображение со скалярными данными. Данные визуализируются с помощью цветовой карты.
- (M, N, 3): изображение с значениями RGB (плавающие числа 0-1 или целые числа 0-255).
- (M, N, 4): изображение со значениями RGBA (плавающие числа 0-1 или целые числа 0-255), то есть включая прозрачность.
Первые два измерения (M, N) определяют строки и столбцы изображения.
Этот параметр может быть передан только позиционно.
-
X, Ytuple или array-like, по умолчанию:
(0, N),(0, M) -
X и Y используются для указания координат четырехугольников. Есть разные способы сделать это:
-
Используйте кортежи
X=(xmin, xmax)иY=(ymin, ymax)для определения равномерной прямоугольной сетки.Кортежи определяют внешние края сетки. Все отдельные четырехугольники будут иметь одинаковый размер. Это самая быстрая версия.
-
Используйте одномерные массивы X, Y для определения неравномерной прямоугольной сетки.
В этом случае X и Y должны быть монотонными одномерными массивами длины N+1 и M+1, задающими x и y границы ячеек.
Скорость средняя. Примечание: сетка проверяется, и если она оказывается равномерной, используется быстрая версия.
-
Используйте двумерные массивы X, Y, если вам нужна произвольная четырехугольная сетка (то есть если четырехугольники не прямоугольные).
В этом случае X и Y являются двумерными массивами формы (M + 1, N + 1), задающими x и y координаты углов цветных четырехугольников.
Это наиболее общий, но самый медленный способ рендеринга. Однако он может создавать более быстрый и компактный вывод при использовании бэкэндов ps, pdf и svg.
Эти аргументы могут быть переданы только позиционно.
-
-
cmapстрока или
Colormap, по умолчанию:rcParams["image.cmap"](по умолчанию:'viridis') -
Объект цветовой карты или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения C с цветами.
-
norm
Normalize, необязательно -
Объект Normalize масштабирует значения данных до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. По умолчанию диапазон данных отображается в диапазоне цветовой шкалы с линейным масштабированием.
- vmin, vmaxчисло, по умолчанию: None
-
Диапазон цветовой шкалы. Если None, подходящие минимальные/максимальные значения автоматически выбираются объектом
Normalize(по умолчанию соответствуют минимальным/максимальным значениям C в случае линейного масштабирования). Использование vmin/vmax при заданном norm устарело. - alphaчисло, по умолчанию: None
-
Значение смешивания альфы, от 0 (прозрачный) до 1 (непрозрачный).
- snapбулево, по умолчанию: False
-
Определяет, необходимо ли привязывать сетку к границам пикселей.
Возвращает: -
AxesImageилиPcolorImageилиQuadMesh -
Тип возвращаемого значения зависит от типа сетки:
AxesImageдля регулярной прямоугольной сетки.PcolorImageдля нерегулярной прямоугольной сетки.QuadMeshдля непрямоугольной сетки.
Другие параметры: - **kwargs
-
Поддерживаемые дополнительные параметры зависят от типа сетки. Смотрите типы возвращаемых значений image для дополнительного описания.
Примечания
Примечание
В дополнение к описанным выше аргументам, эта функция может принимать аргумент data. Если такой аргумент data задан, каждый другой аргумент также может быть строкой
s, которая интерпретируется какdata[s](если это не вызывает исключение).Объекты, переданные как data, должны поддерживать доступ к элементам (
data[s]) и проверку на вхождение (s in data).
Примеры использования matplotlib.axes.Axes.pcolorfast
© 2012–2021 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.4.3/api/_as_gen/matplotlib.axes.Axes.pcolorfast.html