Spec-Zone.ru › Matplotlib 2.2

matplotlib.axes.Axes.pcolorfast

Axes.pcolorfast(*args, 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) для определения равномерной прямоугольной сетки.

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

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

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

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

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

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

    Это самый общий, но самый медленный способ визуализации. Однако он может производить более быстрый и компактный вывод, используя backends 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, подходящие значения min/max автоматически выбираются экземпляром Normalize (по умолчанию это соответствующие значения min/max 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>]:

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

Примеры использования 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/2.2.3/api/_as_gen/matplotlib.axes.Axes.pcolorfast.html

Spec-Zone.ru

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