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 массив

Значения для цветового отображения.

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

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 или имя зарегистрированной цветовой карты. Цветовая карта сопоставляет значения C с цветами.

normNormalize, необязательно

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

vmin, vmaxчисло, по умолчанию: None

Диапазон цветовой шкалы. Если None, подходящие значения min/max автоматически выбираются экземпляром Normalize (по умолчанию, соответствующие min/max значения C в случае линейного масштабирования). Использование vmin/vmax при заданном norm является ошибкой.

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

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

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

Также действует псевдоним edgecolor.

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` или dashes или linestyles или ls	строка или кортеж или список из них
`linewidth` или linewidths или lw	число с плавающей точкой или список чисел с плавающей точкой
`norm`	`Normalize` или None
`offset_transform`	`Transform`
`offsets`	(N, 2) или (2,) массивоподобное значение
`path_effects`	`AbstractPathEffect`
`paths`	список массивоподобных значений
`picker`	None или bool или число с плавающей точкой или вызываемая функция
`pickradius`	число с плавающей точкой
`rasterized`	bool
`sizes`	массив 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.