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{'flat', 'nearest', 'auto'}, необязательно Стиль заливки четырёхугольников; по умолчанию равен '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 для более подробного описания. cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis') Объект цветовой карты или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения 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, но в противном случае может привести к артефактам. **kwargs Кроме того, допускаются следующие аргументы. Они передаются конструктору PolyCollection: Свойство Описание agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив float (m, n, 3) alpha массивоподобный объект или скаляр или None animated bool antialiased или aa или antialiaseds bool или список bool array ndarray или 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 или str или None color цвет или список кортежей rgba contains неизвестно 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_position неизвестно offsets (N, 2) или (2,) массивоподобный объект path_effects AbstractPathEffect picker None или bool или float или вызываемый объект pickradius float rasterized bool sketch_params (scale: float, length: float, randomness: float) snap bool или None transform Transform url строка urls список строк или None visible bool zorder float

См. также

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.

Примечание

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

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

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

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

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