matplotlib.axes.Axes.pcolorfast

Axes.pcolorfast(*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): изображение со скалярными данными. Отображение цвета контролируется параметрами 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), задающими координаты углов цветных четырёхугольников.

  Это наиболее общий, но самый медленный вариант. Однако он может создавать более быстрый и компактный вывод с использованием бэкэндов ps, pdf и svg.

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

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

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

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

normстрока или 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).

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

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

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

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

Возвращаемые значения:

AxesImage или PcolorImage или QuadMesh

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

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

Дополнительные параметры:

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

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

**kwargs

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

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

Демонстрация pcolor

Демонстрация pcolor