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 являются 1-мерными массивами или столбцами, они будут расширены до соответствующих 2-мерных массивов, создавая прямоугольную сетку.

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 удаляются.
• '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 или штрихи или стили_линий или 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	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
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