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.

Параметры:

C : array-like(M, N) Двумерный массив или маскированный массив. Значения будут отображаться в цветовой карте. Этот аргумент может быть передан только позиционно. В некоторых случаях C может быть 3D, с последним измерением как rgb(a). Это доступно, когда C подходит для типа изображения или pcolorimage, вызовет TypeError, если C является 3D и quadmesh. X, Y : tuple 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, N), задающими координаты углов окрашенных четырёхугольников. Подробности см. в pcolormesh. Это самый общий, но самый медленный способ отрисовки. Однако, он может производить более быстрый и компактный вывод при использовании бэкэндов ps, pdf и svg. Эти аргументы могут быть переданы только позиционно. 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

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