matplotlib.axes.Axes.pcolor

Axes.pcolor(self, *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() для обсуждения различий.

Параметры:

Carray-like Массив скалярных значений 2-х мерный. Значения будут отображены в цветовой карте. X, Yarray-like, optional Координаты вершин четырехугольников в 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{'flat', 'nearest', 'auto'}, optional Стиль заливки для четырехугольника; по умолчанию 'flat' или rcParams["pcolor.shading"] (по умолчанию: 'flat'). Возможные значения: '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 сетки и затенение для более подробного описания. cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis') Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения C с цветами. normNormalize, optional Экземпляр Normalize масштабирует значения данных до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. По умолчанию диапазон данных сопоставляется с диапазоном цветовой панели с использованием линейного масштабирования. vmin, vmaxfloat, default: None Диапазон цветовой панели. Если None, подходящие значения min/max автоматически выбираются экземпляром Normalize (по умолчанию соответствующие значения min/max C в случае линейного масштабирования). Использование vmin/vmax устарело, когда задан norm. edgecolors{'none', None, 'face', color, color sequence}, optional Цвет границ. По умолчанию 'none'. Возможные значения: 'none' или '': Без границ. None: rcParams["patch.edgecolor"] (по умолчанию: 'black') будет использоваться. Обратите внимание, что в настоящее время rcParams["patch.force_edgecolor"] (по умолчанию: False) должен быть True для работы этого. 'face': Используется цвет соседней грани. Цвет или последовательность цветов зададут цвет границ. Форма единственного числа edgecolor используется как псевдоним. alphafloat, default: None Значение альфа-смешивания цвета заливки, между 0 (прозрачный) и 1 (непрозрачный). Примечание: цвет границ в настоящее время не зависит от этого. snapbool, default: False Необходимо ли привязывать сетку к пиксельным границам.

Возвращает:

matplotlib.collections.Collection

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

antialiasedsbool, default: False Значение по умолчанию для antialiaseds — False, если используется значение по умолчанию edgecolors="none". Это устраняет искусственные линии на границах области, и работает независимо от значения alpha. Если edgecolors не равно "none", то значение по умолчанию для antialiaseds берется из rcParams["patch.antialiased"] (по умолчанию: True). Отрисовка краёв может быть предпочтительнее, если alpha равно 1, но в противном случае может привести к артефактам. **kwargs Кроме того, разрешены следующие аргументы. Они передаются в конструктор PolyCollection: Свойство Описание agg_filter функция фильтра, которая принимает (m, n, 3) массив float и значение dpi, и возвращает (m, n, 3) массив alpha float или None animated bool antialiased или aa или antialiaseds bool или список bool array ndarray capstyle {'butt', 'round', 'projecting'} clim (vmin: float, vmax: float) clip_box Bbox clip_on bool clip_path Patch или (Path, Transform) или None cmap Colormap или str или None color цвет или список кортежей rgba contains неизвестно edgecolor или ec или edgecolors цвет или список цветов или 'face' facecolor или facecolors или fc цвет или список цветов figure Figure gid str hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout bool joinstyle {'miter', 'round', 'bevel'} label объект linestyle или dashes или linestyles или ls строка или кортеж или список таковых linewidth или linewidths или lw float или список float norm Normalize или None offset_position неизвестно offsets подобный массиву (N, 2) или (2,) path_effects AbstractPathEffect picker None или bool или вызываемый объект pickradius неизвестно rasterized bool или None sketch_params (scale: float, length: float, randomness: float) snap bool или None transform Transform url str urls список строк или None visible bool zorder float

См. также

pcolormesh

для объяснения различий между pcolor и pcolormesh.

imshow

Если X и Y являются равноудалёнными, imshow может быть более быстрой альтернативой.

Примечания

Массивы с пропусками (Masked arrays)

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.

Примечание

Помимо описанных выше аргументов, эта функция может принимать аргумент data. Если такой аргумент data предоставлен, каждый другой аргумент может также быть строкой s, которая интерпретируется как data[s] (если это не вызывает исключения).

Объекты, передаваемые в качестве data, должны поддерживать доступ по элементам (data[s]) и проверку на членство (s in data).

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

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

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