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.

Параметры:

Cмассив-подобный объект

Данные изображения. Поддерживаемые формы массивов:

• (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, Yкортеж или массив-подобный объект, по умолчанию: (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')

Экземпляр 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, vmaxчисло с плавающей точкой, необязательно

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

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

alphaчисло с плавающей точкой, по умолчанию: None

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

snapбулево значение, по умолчанию: False

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

Возвращает:

AxesImage или PcolorImage или QuadMesh

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

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

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

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

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

**kwargs

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

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

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

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