Spec-Zone.ru › Matplotlib 3.2

matplotlib.axes.Axes.pcolorfast

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

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

Вызов функции:

ax.pcolorfast([X, Y], C, /, **kwargs)

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

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

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

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

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

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

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

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

X, Ytuple or array-like, default: (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.

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

cmapstr or Colormap, optional

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

normNormalize, optional

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

vmin, vmaxscalar, optional, default: None

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

alphascalar, optional, default: None

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

snapbool, optional, default: False

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

Возвращает:
imageAxesImage or PcolorImage or QuadMesh

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

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

Примечания

Примечание

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

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

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

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

Pcolor Demo

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

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

Spec-Zone.ru

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