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() для обсуждения отличий.

Параметры:

C2D массив

Значения, отображаемые в цветах. Отображение цветов контролируется 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 вида строки вместе с vmin/vmax допустимо).

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

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

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

Единочный параметр edgecolor используется как синоним.

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

Значение смешивания alpha цвета заливки, между 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 или штрихи или 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