matplotlib.pyplot.pcolor

matplotlib.pyplot.pcolor(*args, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, data=None, **kwargs) [source]

Создать псевдоцветной график с нерегулярной прямоугольной сеткой.

Вызов:

pcolor([X, Y,] C, **kwargs)

X и Y могут быть использованы для указания углов четырёхугольников.

Подсказка

pcolor() может быть очень медленным для больших массивов. В большинстве случаев следует использовать аналогичную, но намного более быструю функцию pcolormesh вместо неё. Там содержится обсуждение различий.

Параметры:

Carray-like Скалярный массив 2-мерный. Значения будут отображаться с помощью цветовой карты. X, Yarray-like, optional Координаты углов четырёхугольника. Четырёхугольник для C[i, j] имеет углы в: (X[i+1, j], Y[i+1, j]) (X[i+1, j+1], Y[i+1, j+1]) +---------+ | C[i, j] | +---------+ (X[i, j], Y[i, j]) (X[i, j+1], Y[i, j+1]) Обратите внимание, что индекс столбца соответствует координате x, а индекс строки - координате y. Подробности см. в разделе Примечания ниже. Размеры X и Y должны быть на единицу больше, чем размеры C. Кроме того, X, Y и C могут иметь одинаковые размеры, в этом случае последняя строка и столбец C будут проигнорированы. Если X и/или Y являются одномерными массивами или столбцами, они будут расширены до необходимых двумерных массивов, создавая прямоугольную сетку. cmapstr or Colormap, optional Объект Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения C с цветами. По умолчанию используется rcParams["image.cmap"] (по умолчанию: 'viridis'). normNormalize, optional Объект Normalize масштабирует значения данных в диапазон канонической цветовой карты [0, 1] для сопоставления с цветами. По умолчанию диапазон данных отображается в диапазоне цветовой шкалы с линейным масштабированием. vmin, vmaxscalar, optional, default: None Диапазон цветовой шкалы. Если None, подходящие значения min/max автоматически выбираются объектом Normalize (по умолчанию - соответствующие значения min/max C в случае линейного масштабирования). edgecolors{'none', None, 'face', color, color sequence}, optional Цвет границ. По умолчанию 'none'. Возможные значения: 'none' или '': Без границ. None: rcParams["patch.edgecolor"] (по умолчанию: 'black') будет использован. Обратите внимание, что в настоящее время rcParams["patch.force_edgecolor"] (по умолчанию: False) должен быть True для работы этой функции. 'face': Использование цвета соседней грани. Цвет или последовательность цветов задаст цвет границ. Единочный вариант edgecolor работает как псевдоним. alphascalar, optional, default: None Значение альфа-смешивания цвета заполнения, от 0 (прозрачный) до 1 (непрозрачный). Примечание: цвет границ в настоящее время не зависит от этого. snapbool, optional, default: False Необходимо ли привязывать сетку к границам пикселей.

Возвращает:

collectionmatplotlib.collections.Collection

Дополнительные параметры:

antialiasedsbool, optional, 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, и возвращает массив float (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 цветовая карта или зарегистрированное имя цветовой карты 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 или последовательность чисел с плавающей точкой norm Normalize offset_position {'экран', 'данные'} offsets массив-подобный объект (N, 2) или (2,) path_effects AbstractPathEffect picker None или bool или float или вызываемый объект pickradius неизвестно rasterized bool или None sketch_params (масштаб: float, длина: float, случайность: float) snap bool или None transform Transform url строка str 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.

Обработка граничных случаев pcolor()

pcolor() отображает все столбцы C, если X и Y не указаны или если X и Y имеют на один столбец больше, чем C. Если X и Y имеют такое же количество столбцов, как C, то последний столбец C отбрасывается. Аналогично для строк.

Примечание: Это поведение отличается от поведения MATLAB's pcolor(), который всегда отбрасывает последнюю строку и столбец C.

Примечание

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

• Все позиционные и все ключевые аргументы.

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

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

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

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