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 являются 1-мерными массивами или столбцами, они будут расширены в 2-мерные массивы, чтобы создать прямоугольную сетку, как необходимо. 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 отбрасываются. '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, подходящие минимальное/максимальное значения выбираются автоматически экземпляром 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, но в противном случае может привести к артефактам. **kwargs Кроме того, допускаются следующие аргументы. Они передаются в конструктор PolyCollection: Свойство Описание agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (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 или строка или 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 или число с плавающей точкой или вызываемый объект pickradius число с плавающей точкой rasterized bool 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