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 значениями (0-1 float или 0-255 int).
• (M, N, 4): изображение с RGBA значениями (0-1 float или 0-255 int), т.е. включая прозрачность.

Первые два измерения (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).

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

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

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

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

Возвращает:

AxesImage или PcolorImage или QuadMesh

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

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

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

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

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

**kwargs

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

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

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

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