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

Параметры:

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 функция фильтра, которая принимает массив float (m, n, 3) и значение 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 строка hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout bool 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 или вызываемый объект pickradius неизвестно rasterized bool или None sketch_params (scale: float, length: float, randomness: float) snap bool или None transform Transform url строка urls список строк или None 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.

Примечание

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

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

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

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

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