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): изображение со скалярными данными. Данные визуализируются с использованием цветовой карты.
• (M, N, 3): изображение с значениями RGB (0-1 с плавающей точкой или 0-255 целое число).
• (M, N, 4): изображение со значениями RGBA (0-1 с плавающей точкой или 0-255 целое число), т.е. с прозрачностью.

Первые два измерения (M, N) определяют строки и столбцы изображения.

Этот параметр может передаваться только позиционно.

X, Yкортеж или 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.

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

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

Экземпляр цветовой карты или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения C с цветами.

normNormalize, необязательно

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

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

Диапазон цветовой полосы. Если None, подходящие минимальные/максимальные значения выбираются автоматически экземпляром Normalize (по умолчанию это соответствующие минимальное/максимальное значения C в случае линейного масштабирования). Использование vmin/vmax при заданном norm является ошибкой.

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

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

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

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

Возвращает

AxesImage или PcolorImage или QuadMesh

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

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

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

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

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

**kwargs

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

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