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массив, необязательно

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

(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 является ошибкой (но использование имени norm типа str вместе с vmin/vmax допустимо).

edgecolors{'none', None, 'face', цвет, последовательность цветов}, необязательно

Цвет границ. По умолчанию 'none'. Возможные значения:

• 'none' или '': Без границы.
• None: rcParams["patch.edgecolor"] (по умолчанию: 'black') будет использоваться. Обратите внимание, что в настоящее время rcParams["patch.force_edgecolor"] (по умолчанию: False) должен быть True для работы.
• 'face': Используется цвет смежной грани.
• Цвет или последовательность цветов задают цвет границы.

edgecolor также работает как псевдоним.

alphafloat, по умолчанию: None

Значение альфа-смешивания цвета грани, от 0 (прозрачный) до 1 (непрозрачный). Примечание: цвет границы на данный момент этим не затрагивается.

snapbool, по умолчанию: False

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

Возвращает:

matplotlib.collections.PolyQuadMesh

Другие параметры:

antialiasedsbool, по умолчанию: False

Значение по умолчанию antialiaseds равно False, если используется значение по умолчанию edgecolors="none". Это устраняет искусственные линии на границах участков и работает независимо от значения alpha. Если edgecolors не "none", то значение по умолчанию antialiaseds берется из rcParams["patch.antialiased"] (по умолчанию: True). Рисование границ может быть предпочтительнее, если alpha равен 1, но в противном случае вызовет артефакты.

dataиндексируемый объект, необязательно

Если задан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).

**kwargs

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

Свойство	Описание
agg_filter	функция фильтра, которая принимает (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	BboxBase или None
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	строка или кортеж или список таких кортежей
linewidth или linewidths или lw	число с плавающей запятой или список чисел с плавающей запятой
mouseover	bool
norm	Normalize или строка или None
offset_transform или transOffset	Transform
offsets	(N, 2) или (2,) массивоподобный объект
path_effects	список AbstractPathEffect
paths	список массивоподобных объектов
picker	None или bool или число с плавающей запятой или вызываемая функция
pickradius	число с плавающей запятой
rasterized	bool
sizes	numpy.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

float

См. также

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

Управление пределами области просмотра с помощью полей и sticky_edges

Управление пределами области просмотра с помощью полей и sticky_edges