matplotlib.axes.Axes.pcolorfast
-
Axes.pcolorfast(*args, data=None, **kwargs)[source] -
Создать псевдоцветное изображение с нерегулярной прямоугольной сеткой.
Подписи вызова:
ax.pcolorfast(C, **kwargs) ax.pcolorfast(xr, yr, C, **kwargs) ax.pcolorfast(x, y, C, **kwargs) ax.pcolorfast(X, Y, C, **kwargs)
Этот метод похож на ~.Axes.pcolor` и
pcolormesh. Он разработан для обеспечения наиболее быстрого построения графиков типа pcolor с использованием бэкенда Agg. Для этого он использует различные алгоритмы в зависимости от сложности входной сетки (регулярная прямоугольная, нерегулярная прямоугольная или произвольная четырехугольная).Предупреждение
Этот метод экспериментальный. По сравнению с
pcolorилиpcolormeshон имеет некоторые ограничения:- Он поддерживает только плоское затенение (без контуров)
- Он не поддерживает логарифмическое масштабирование осей.
- Он не имеет обертки pyplot.
Параметры: -
C : array-like(M, N) -
Массив 2D скалярных величин. Значения будут отображаться в цветовой карте. C может быть массив с масками.
-
x, y : tuple or array-like -
X и Y используются для указания координат четырехугольников. Существуют различные способы сделать это:
-
Используйте кортежи
xr=(xmin, xmax)иyr=(ymin, ymax)для определения равномерной прямоугольной сетки.Кортежи определяют внешние границы сетки. Все отдельные четырехугольники будут одинакового размера. Это самая быстрая версия.
-
Используйте массивы 1D x, y для указания неравномерной прямоугольной сетки.
В этом случае x и y должны быть монотонными массивами 1D длиной N+1 и M+1, определяющими границы ячеек по x и y.
Скорость является средней. Примечание: сетка проверяется, и если она равномерна, используется быстрая версия.
-
Используйте массивы 2D X, Y, если вам нужна произвольная четырехугольная сетка (т. е. если четырехугольники не являются прямоугольниками).
В этом случае X и Y являются массивами 2D с формой (M, N), определяющими координаты углов цветных четырехугольников. Подробнее см.
pcolormesh.Это самый общий, но самый медленный способ визуализации. Однако он может производить более быстрый и компактный вывод, используя backends ps, pdf и svg.
Если x и y не указаны, по умолчанию используются
xr=(0, N),yr=(O, M). -
-
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 в случае линейного масштабирования). -
alpha : scalar, optional, default: None -
Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный).
-
snap : bool, optional, default: False -
Привязать ли сетку к границам пикселей.
Возвращает: -
image : AxesImage or PcolorImage or QuadMesh -
Тип возвращаемого значения зависит от типа сетки:
-
AxesImageдля регулярной прямоугольной сетки. -
PcolorImageдля нерегулярной прямоугольной сетки. -
QuadMeshдля непрямоугольной сетки.
-
Примечания
Примечание
Помимо описанных выше аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:
- Все позиционные и все ключевые аргументы.
Примеры использования matplotlib.axes.Axes.pcolorfast
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/2.2.3/api/_as_gen/matplotlib.axes.Axes.pcolorfast.html