Spec-Zone.ru › Matplotlib 3.4

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, 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.

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

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

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

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

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

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

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

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

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

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

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

Возвращает:
AxesImage или PcolorImage или QuadMesh

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

  • AxesImage для регулярной прямоугольной сетки.
  • PcolorImage для нерегулярной прямоугольной сетки.
  • QuadMesh для непрямоугольной сетки.
Другие параметры:
**kwargs

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

Примечания

Примечание

В дополнение к описанным выше аргументам, эта функция может принимать аргумент data. Если такой аргумент data задан, каждый другой аргумент также может быть строкой s, которая интерпретируется как data[s] (если это не вызывает исключение).

Объекты, переданные как data, должны поддерживать доступ к элементам (data[s]) и проверку на вхождение (s in data).

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

Pcolor Demo

Pcolor Demo

© 2012–2021 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.4.3/api/_as_gen/matplotlib.axes.Axes.pcolorfast.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API