matplotlib.axes.Axes.pcolorfast
-
Axes.pcolorfast(*args, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, 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)для определения равномерной прямоугольной сетки.Кортежи определяют внешние границы сетки. Все отдельные четырехугольники будут одинакового размера. Это самый быстрый вариант.
-
Используйте одномерные массивы x, y для задания неравномерной прямоугольной сетки.
В этом случае x и y должны быть монотонными одномерными массивами длины N+1 и M+1, задающими границы ячеек по осям x и y.
Скорость средняя. Примечание: Сетка проверяется, и если она равномерна, используется быстрый вариант.
-
Используйте двумерные массивы X, Y, если вам нужна произвольная четырехугольная сетка (т.е. если четырехугольники не прямоугольные).
В этом случае X и Y — двумерные массивы формы (M, N), задающие координаты углов цветных четырехугольников. Подробнее см.
pcolormesh.Это самый общий, но самый медленный способ отрисовки. Однако он может генерировать более быстрый и компактный вывод при использовании бэкэндов 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, подходящие минимальное и максимальное значения автоматически выбираются экземпляром
Normalize(по умолчанию равны соответствующим минимальным и максимальным значениям 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>]:
- Все позиционные и все ключевые аргументы.
Объекты, переданные как data, должны поддерживать доступ по элементам (
data[<arg>]) и проверку на вхождение (<arg> in data).
Примеры использования matplotlib.axes.Axes.pcolorfast
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.0.0/api/_as_gen/matplotlib.axes.Axes.pcolorfast.html