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)
Этот метод похож на
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, default: rcParams["image.cmap"] (default: 'viridis') -
Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения C с цветами.
-
normNormalize, optional -
Экземпляр Normalize масштабирует значения данных до канонического диапазона цветовой карты [0, 1] для сопоставления с цветами. По умолчанию диапазон данных сопоставляется с диапазоном цветовой шкалы с использованием линейного масштабирования.
-
vmin, vmaxfloat, default: None -
Диапазон цветовой шкалы. Если None, подходящие значения min/max автоматически выбираются экземпляром
Normalize(по умолчанию это соответствующие значения min/max C в случае линейного масштабирования). Использование vmin/vmax устарело, когда задан norm. -
alphafloat, default: None -
Значение альфа-смешивания, между 0 (прозрачный) и 1 (непрозрачный).
-
snapbool, default: False -
Необходимо ли привязать сетку к границам пикселей.
Возвращает: -
AxesImage or PcolorImage orQuadMesh -
Тип возвращаемого значения зависит от типа сетки:
-
AxesImageдля регулярной прямоугольной сетки. -
PcolorImageдля нерегулярной прямоугольной сетки. -
QuadMeshдля непрямоугольной сетки.
-
Другие параметры: - **kwargs
-
Поддерживаемые дополнительные параметры зависят от типа сетки. См. типы возвращаемых значений image для получения дополнительной информации.
Примечания
Примечание
Помимо описанных выше аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, все остальные аргументы также могут быть строками
s, которые интерпретируются какdata[s](если это не приводит к исключению).Объекты, переданные как data, должны поддерживать доступ к элементам (
data[s]) и проверку на вхождение (s in data).
Примеры использования matplotlib.axes.Axes.pcolorfast
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.3.3/api/_as_gen/matplotlib.axes.Axes.pcolorfast.html