matplotlib.axes.Axes.pcolorfast
-
Axes.pcolorfast(self, *args, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, data=None, **kwargs)[source] -
Создать псевдоцветной график с нерегулярной прямоугольной сеткой.
Вызов функции:
ax.pcolorfast([X, Y], C, /, **kwargs)
Этот метод аналогичен методу ~.Axes.pcolor` и
pcolormesh. Он предназначен для обеспечения самого быстрого построения графиков типа pcolor с использованием бэкэнда Agg. Для этого он использует различные алгоритмы в зависимости от сложности входной сетки (регулярная прямоугольная, нерегулярная прямоугольная или произвольная четырёхугольная).Предупреждение
Этот метод является экспериментальным. По сравнению с
pcolorилиpcolormeshон имеет некоторые ограничения:- Он поддерживает только плоское затенение (без контуров)
- Он не поддерживает логарифмическую шкалу осей.
- Он не имеет обёртки pyplot.
Параметры: -
Carray-like(M, N) -
Данные изображения. Поддерживаются следующие формы массивов:
- (M, N): изображение со скалярными данными. Данные визуализируются с помощью цветовой карты.
- (M, N, 3): изображение с RGB-значениями (плавающие числа от 0 до 1 или целые числа от 0 до 255).
- (M, N, 4): изображение с RGBA-значениями (плавающие числа от 0 до 1 или целые числа от 0 до 255), т. е. включая прозрачность.
Первые два измерения (M, N) определяют строки и столбцы изображения.
Этот параметр можно передавать только позиционно.
-
X, Ytuple or array-like, default: (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.
Эти аргументы можно передавать только позиционно.
-
-
cmapstr or Colormap, optional -
Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения C с цветами. По умолчанию используется
rcParams["image.cmap"](по умолчанию: 'viridis'). -
normNormalize, optional -
Экземпляр Normalize масштабирует значения данных до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. По умолчанию диапазон данных отображается в диапазоне цветовой шкалы с использованием линейного масштабирования.
-
vmin, vmaxscalar, optional, default: None -
Диапазон цветовой шкалы. Если None, подходящие значения min/max автоматически выбираются экземпляром
Normalize(по умолчанию — соответствующие значения min/max C в случае линейного масштабирования по умолчанию). -
alphascalar, optional, default: None -
Значение альфа-смешивания, между 0 (прозрачный) и 1 (непрозрачный).
-
snapbool, optional, default: False -
Определяет, нужно ли привязывать сетку к границам пикселей.
Возвращает: -
imageAxesImage 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.2.2/api/_as_gen/matplotlib.axes.Axes.pcolorfast.html