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 массив-подобный объект

Значения для построения цветовой карты.

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

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

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

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

Диапазон цветовой панели. Если None, подходящие минимальные и максимальные значения автоматически выбираются объектом Normalize (по умолчанию — соответственно минимальные и максимальные значения 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	массив NumPy или 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.axes.Axes.pcolor