matplotlib.axes.Axes.pcolorfast

Axes.pcolorfast(*args, data=None, **kwargs)

псевдоцветное отображение 2-мерного массива

Экспериментальная функция; это метод типа pcolor, который обеспечивает максимально быстрое отображение с использованием бэкэнда Agg и может обрабатывать любую четырёхугольную сетку. Он поддерживает только плоское затенение (без контуров), не поддерживает логарифмическую шкалу осей и не имеет обёртки pyplot.

Варианты вызова:

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

C — это 2-мерный массив значений цвета, соответствующих четырёхугольным ячейкам. Пусть (nr, nc) — его размер. C может быть массивкой с пропускаемыми элементами.

ax.pcolorfast(C, **kwargs) эквивалентно ax.pcolorfast([0,nc], [0,nr], C, **kwargs)

xr, yr задают диапазоны x и y, соответствующие прямоугольной области, ограничивающей C. Если:

xr = [x0, x1]

и:

yr = [y0,y1]

то x изменяется от x0 до x1 по мере того, как второй индекс C изменяется от 0 до nc, и т.д. (x0, y0) — это внешний угол ячейки (0,0), а (x1, y1) — внешний угол ячейки (nr-1, nc-1). Все ячейки — прямоугольники одинакового размера. Это самый быстрый вариант.

x, y — монотонные одномерные массивы длины nc +1 и nr +1 соответственно, задающие границы ячеек по осям x и y. Следовательно, ячейки прямоугольные, но сетка может быть неравномерной. Скорость промежуточная. (Сетка проверяется, и если она равномерная, используется быстрый вариант.)

X и Y — двумерные массивы размера (nr +1, nc +1), задающие (x,y) координаты углов цветных четырёхугольников; четырёхугольник для C[i,j] имеет углы в (X[i,j],Y[i,j]), (X[i,j+1],Y[i,j+1]), (X[i+1,j],Y[i+1,j]), (X[i+1,j+1],Y[i+1,j+1]). Ячейки необязательно должны быть прямоугольными. Это наиболее общий, но самый медленный вариант отображения. Однако он может давать более быстрый и компактный вывод с помощью бэкэндов ps, pdf и svg.

Обратите внимание, что индекс столбца соответствует координате x, а индекс строки — координате y; подробности см. в Ориентации сетки.

Необязательные ключевые аргументы:

cmap: [ None | Colormap ]

Экземпляр matplotlib.colors.Colormap из cm. Если None, используются настройки rc.

norm: [ None | Normalize ]

Экземпляр matplotlib.colors.Normalize используется для масштабирования данных яркости до 0,1. Если None, используется по умолчанию normalize()

vmin/vmax: [ None | scalar ]

vmin и vmax используются совместно с norm для нормализации данных яркости. Если любой из них равен None, используется минимум и максимум массива цвета C. Если вы передаёте экземпляр norm, vmin и vmax будут равны None.

alpha: 0 <= scalar <= 1 or None

значение альфа-смешивания

Значение возврата — изображение, если задана обычная или прямоугольная сетка, и коллекция QuadMesh в общем случае четырёхугольной сетки.

Примечание

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

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