Spec-Zone.ru › Matplotlib 3.0

matplotlib.axes.Axes.pcolorfast

Axes.pcolorfast(*args, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, data=None, **kwargs) [source]

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

Вызовы:

ax.pcolorfast(C, **kwargs)
ax.pcolorfast(xr, yr, C, **kwargs)
ax.pcolorfast(x, y, C, **kwargs)
ax.pcolorfast(X, Y, C, **kwargs)

Этот метод аналогичен методу ~.Axes.pcolor` и pcolormesh. Он предназначен для предоставления самого быстрого рисования типа pcolor с использованием бэкэнда Agg. Для достижения этого он использует различные алгоритмы в зависимости от сложности входной сетки (регулярная прямоугольная, нерегулярная прямоугольная или произвольная четырехугольная).

Предупреждение

Этот метод является экспериментальным. По сравнению с pcolor или pcolormesh у него есть некоторые ограничения:

  • Он поддерживает только плоское затенение (без контуров)
  • Он не поддерживает логарифмическое масштабирование осей.
  • Он не имеет обертки pyplot.
Параметры:
C : array-like(M, N)

Массив 2D скалярных значений. Значения будут отображаться в виде цвета. C может быть массив с пропускаемыми значениями.

x, y : tuple or array-like

X и Y используются для указания координат четырехугольников. Есть несколько способов сделать это:

  • Используйте кортежи xr=(xmin, xmax) и yr=(ymin, ymax) для определения равномерной прямоугольной сетки.

    Кортежи определяют внешние границы сетки. Все отдельные четырехугольники будут одинакового размера. Это самый быстрый вариант.

  • Используйте одномерные массивы x, y для задания неравномерной прямоугольной сетки.

    В этом случае x и y должны быть монотонными одномерными массивами длины N+1 и M+1, задающими границы ячеек по осям x и y.

    Скорость средняя. Примечание: Сетка проверяется, и если она равномерна, используется быстрый вариант.

  • Используйте двумерные массивы X, Y, если вам нужна произвольная четырехугольная сетка (т.е. если четырехугольники не прямоугольные).

    В этом случае X и Y — двумерные массивы формы (M, N), задающие координаты углов цветных четырехугольников. Подробнее см. pcolormesh.

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

Если опустить x и y, по умолчанию будут использоваться xr=(0, N), yr=(O, M).

cmap : str or Colormap, optional

Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта отображает значения C в цвета. По умолчанию используется rcParams["image.cmap"].

norm : Normalize, optional

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

vmin, vmax : scalar, optional, default: None

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

alpha : scalar, optional, default: None

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

snap : bool, optional, default: False

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

Возвращаемое значение:
image : AxesImage or PcolorImage or QuadMesh

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

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

Примечания

Примечание

В дополнение к описанным выше аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

  • Все позиционные и все ключевые аргументы.

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

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

../../_images/sphx_glr_pcolor_demo_thumb.png

Пример использования pcolor

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

Spec-Zone.ru

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