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{'плоский', 'ближайший', 'авто'}, по умолчанию: rcParams["pcolor.shading"] (по умолчанию: 'auto')

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

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

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

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

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

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

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

vmin, vmaxчисло с плавающей точкой, необязательно

При использовании скалярных данных и отсутствии явного norm, vmin и vmax определяют диапазон данных, который охватывает цветовая карта. По умолчанию цветовая карта охватывает весь диапазон значений предоставленных данных.

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

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

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

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

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

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

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

matplotlib.collections.Collection

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

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

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

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

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

**kwargs

Кроме того, разрешены следующие аргументы. Они передаются в конструктор 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 или штрихи или linestyles или ls	строка или кортеж или список кортежей
linewidth или linewidths или lw	вещественное число или список вещественных чисел
mouseover	bool
norm	Normalize или строка или None
offset_transform или transOffset	неизвестно
offsets	массив (N, 2) или (2,)
path_effects	AbstractPathEffect
paths	список подобных массивам
picker	None или bool или float или вызываемый объект
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	вещественное число

См. также

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 с размерами (число строк, число столбцов) отображается с номером столбца как X и номером строки как Y.

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

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

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

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

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