matplotlib.pyplot.pcolor

matplotlib.pyplot.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, то поднимается предупреждение о deprecation, и последняя строка и столбец 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, vmaxчисло с плавающей точкой, необязательно

При использовании скалярных данных и отсутствии явного 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 работает как псевдоним.

alphaчисло с плавающей точкой, по умолчанию: None

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

snapлогическое значение, по умолчанию: False

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

Возвращаемое значение:

matplotlib.collections.PolyQuadMesh

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

antialiasedsлогическое значение, по умолчанию: 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	булево значение
zorder	число с плавающей точкой

См. также

pcolormesh

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

imshow

Если X и Y равномерно распределены, imshow может быть более быстрым вариантом.

Примечания

Примечание

Это обертка pyplot для axes.Axes.pcolor.

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

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.pyplot.pcolor

Изображения pcolor

Изображения pcolor

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

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