matplotlib.axes.Axes.pcolorfast

Axes.pcolorfast(*args, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, colorizer=None, data=None, **kwargs)[исходный код]

Создаёт псевдоцветный график с нерегулярной прямоугольной сеткой.

Сигнатура вызова:

ax.pcolorfast([X, Y], C, /, **kwargs)

Аргументы X, Y, C можно передавать только позиционно.

Этот метод похож на pcolor и pcolormesh. Он предназначен для построения графиков типа pcolor с максимальной скоростью при использовании бэкенда Agg. Для этого внутри используются разные алгоритмы в зависимости от сложности входной сетки (регулярная прямоугольная, нерегулярная прямоугольная или произвольная четырёхугольная).

Предупреждение

Этот метод является экспериментальным. По сравнению с pcolor или pcolormesh у него есть некоторые ограничения:

• Поддерживается только плоское затенение (без контуров).
• Не поддерживается логарифмическое масштабирование осей.
• Для него нет обёртки pyplot.

Параметры:

Carray-like

Данные изображения. Поддерживаются массивы следующих форм:

• (M, N): изображение со скалярными данными. Сопоставление цветов задаётся параметрами cmap, norm, vmin и vmax.
• (M, N, 3): изображение со значениями RGB (float от 0 до 1 или int от 0 до 255).
• (M, N, 4): изображение со значениями RGBA (float от 0 до 1 или int от 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 он может создавать более компактный вывод и отрисовываться быстрее.

Эти аргументы можно передавать только позиционно.

cmapstr или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

Экземпляр Colormap или имя зарегистрированной цветовой карты, используемые для сопоставления скалярных данных с цветами.

Этот параметр игнорируется, если C — RGB(A).

normstr или Normalize, необязательный

Метод нормализации, используемый для масштабирования скалярных данных в диапазон [0, 1] перед сопоставлением с цветами с помощью cmap. По умолчанию используется линейное масштабирование: минимальное значение отображается как 0, а максимальное — как 1.

Если задан, параметр может быть одним из следующих:

• Экземпляр Normalize или одного из его подклассов (см. Нормализация цветовой карты).
• Название шкалы, например "linear", "log", "symlog", "logit" и т. д. Чтобы получить список доступных шкал, вызовите matplotlib.scale.get_scale_names(). В этом случае подходящий подкласс Normalize создаётся и инстанцируется динамически.

Этот параметр игнорируется, если C — RGB(A).

vmin, vmaxfloat, необязательный

При использовании скалярных данных и отсутствии явно заданного norm, vmin и vmax задают диапазон данных, охватываемый цветовой картой. По умолчанию цветовая карта охватывает полный диапазон значений переданных данных. Использовать vmin/vmax вместе с экземпляром norm нельзя (однако допустимо использовать имя norm типа str вместе с vmin/vmax).

Этот параметр игнорируется, если C — RGB(A).

colorizerColorizer или None, по умолчанию: None

Объект Colorizer, используемый для сопоставления цвета с данными. Если задано None, объект Colorizer создаётся на основе norm и cmap.

Этот параметр игнорируется, если C — RGB(A).

alphafloat, по умолчанию: None

Значение альфа-смешивания от 0 (прозрачный) до 1 (непрозрачный).

snapbool, по умолчанию: False

Следует ли привязывать сетку к границам пикселей.

Возвращает:

AxesImage или PcolorImage или QuadMesh

Тип возвращаемого значения зависит от типа сетки:

• AxesImage для регулярной прямоугольной сетки.
• PcolorImage для нерегулярной прямоугольной сетки.
• QuadMesh для непрямоугольной сетки.

Другие параметры:

dataиндексируемый объект, необязательный

Если задан, для всех параметров также принимается строка s, которая интерпретируется как data[s], если s является ключом в data.

**kwargs

Поддерживаемые дополнительные параметры зависят от типа сетки. Дополнительные сведения см. в описании возвращаемых типов для image.

Примеры использования matplotlib.axes.Axes.pcolorfast

Изображения pcolor

Изображения pcolor