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

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

(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 допустимо).

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.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 или число с плавающей точкой или вызываемая функция
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 с формой (nrows, ncolumns) отображается с номером столбца как X и номером строки как Y.

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

Пример pcolor

Пример pcolor

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

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