matplotlib.axes.Axes.pcolor

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

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

Вызов:

pcolor([X, Y,] C, **kwargs)

X и Y могут использоваться для указания углов четырёхугольников.

Подсказка

pcolor() может быть очень медленным для больших массивов. В большинстве случаев вы должны использовать аналогичную, но гораздо более быструю pcolormesh функцию. См. Различия между pcolor() и pcolormesh() для обсуждения различий.

Параметры:

CДвумерный массив-подобный объект

Значения для сопоставления с цветами. Сопоставление с цветами контролируется параметрами cmap, norm, vmin и vmax.

X, Yмассивоподобные объекты, необязательно

Координаты углов четырёхугольников:

(X[i+1, j], Y[i+1, j])       (X[i+1, j+1], Y[i+1, j+1])
                      +-----+
                      |     |
                      +-----+
    (X[i, j], Y[i, j])       (X[i, j+1], Y[i, j+1])

Обратите внимание, что индекс столбца соответствует координате x, а индекс строки — y. Подробности см. в разделе Примечания ниже.

Если shading='flat' размеры X и Y должны быть на единицу больше, чем размеры C, и четырёхугольник окрашивается в соответствии со значением в C[i, j]. Если X, Y и C имеют одинаковые размеры, будет выведено предупреждение, и последняя строка и столбец C будут проигнорированы.

Если shading='nearest', размеры X и Y должны быть такими же, как у C (в противном случае будет поднято исключение ValueError). Цвет C[i, j] будет центрирован на (X[i, j], Y[i, j]).

Если X и/или Y являются одномерными массивами или столбцами, они будут расширены по мере необходимости до соответствующих двумерных массивов, образуя прямоугольную сетку.

shading{'flat', 'nearest', 'auto'}, по умолчанию: rcParams["pcolor.shading"] (по умолчанию: 'auto')

Стиль заливки четырёхугольника. Возможные значения:

• 'flat': Для каждого четырёхугольника используется твёрдый цвет. Цвет четырёхугольника (i, j), (i+1, j), (i, j+1), (i+1, j+1) задаётся C[i, j]. Размеры X и Y должны быть на единицу больше, чем размеры C; если они такие же, как C, то поднимается предупреждение о устаревании, и последняя строка и столбец C отбрасываются.
• 'nearest': Каждый узел сетки будет иметь цвет, центрированный на нём, занимая половину расстояния между соседними центрами узлов сетки. Размеры X и Y должны быть такими же, как у C.
• 'auto': Выбирает 'flat', если размеры X и Y на единицу больше C. Выбирает 'nearest', если размеры одинаковы.

См. pcolormesh сетки и заливка для более подробного описания.

cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

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

normстрока или Normalize, необязательно

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

Если задано, может быть одним из следующих:

• Экземпляр Normalize или один из его подклассов (см. Нормализация цветовых карт).
• Имя шкалы, например, "linear", "log", "symlog", "logit" и т.д. Для списка доступных шкал вызовите matplotlib.scale.get_scale_names(). В этом случае подкласс Normalize будет динамически сгенерирован и создан.

vmin, vmaxfloat, необязательно

При использовании скалярных данных и отсутствии явного norm, vmin и vmax определяют диапазон данных, который покрывает цветовая карта. По умолчанию цветовая карта охватывает весь диапазон значений предоставленных данных. Использование vmin/vmax с экземпляром norm является ошибкой (но использование имени str norm вместе с vmin/vmax допустимо).

Кроме того, разрешены следующие аргументы. Они передаются конструктору PolyCollection:

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	подобный массиву или скаляр или None
animated	bool
antialiased или aa или antialiaseds	bool или список bool
array	подобный массиву или None
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	Bbox
clip_on	bool
clip_path	Patch или (Path, Transform) или None
cmap	Colormap или строка или None
color	цвет или список кортежей rgba
edgecolor или ec или edgecolors	цвет или список цветов или 'face'
facecolor или facecolors или fc	цвет или список цветов
figure	Figure
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или dashes или linestyles или ls	строка или кортеж или список thereof
linewidth или linewidths или lw	число с плавающей точкой или список чисел с плавающей точкой
mouseover	bool
norm	Normalize или строка или None
offset_transform или transOffset	неизвестно
offsets	(N, 2) или (2,) подобный массиву
path_effects	AbstractPathEffect
paths	список подобных массиву
picker	None или bool или число с плавающей точкой или вызываемый объект
pickradius	неизвестно
rasterized	bool
sizes	массив ndarray или None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	строка
urls	список строк или None
verts	список подобных массиву
verts_and_codes	неизвестно
visible	bool
zorder	число с плавающей точкой

См. также

pcolormesh

для объяснения различий между pcolor и pcolormesh.

imshow

Если X и Y являются равноудалёнными, imshow может быть более быстрой альтернативой.

Примечания

Маскированные массивы

X, Y и C могут быть маскированными массивами. Если либо C[i, j], или один из вершин, окружающих C[i, j] (X или Y в [i, j], [i+1, j], [i, j+1], [i+1, j+1] ), маскирован, то ничего не рисуется.

Ориентация сетки

Ориентация сетки следует стандартной матричной конвенции: Массив C с формой (nrows, ncolumns) рисуется с номером столбца как X и номером строки как Y.

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

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

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

Управление пределами отображения с помощью отступов и привязки к краям

Управление пределами отображения с помощью отступов и привязки к краям