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 вместо неё. См. там обсуждение различий.

Параметры:

C : array_like Скалярный 2-мерный массив. Значения будут отображаться в цвете. X, Y : array_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 являются одномерными массивами или столбцами, они будут расширены до нужных 2-мерных массивов, создавая прямоугольную сетку. cmap : str or Colormap, optional Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения C с цветами. По умолчанию используется rcParams["image.cmap"]. norm : Normalize, optional Экземпляр Normalize масштабирует значения данных до канонического диапазона цветовой карты [0, 1] для сопоставления с цветами. По умолчанию диапазон данных сопоставляется с диапазоном цветовой шкалы с линейным масштабированием. vmin, vmax : scalar, optional, default: None Диапазон цветовой шкалы. Если None, подходящие минимальные/максимальные значения автоматически выбираются экземпляром Normalize (по умолчанию это минимальное/максимальное значения C в случае линейного масштабирования). edgecolors : {'none', None, 'face', color, color sequence}, optional Цвет границ. По умолчанию 'none'. Возможные значения: 'none' или '': Нет границ. None: Будет использован rcParams["patch.edgecolor"]. Обратите внимание, что в настоящее время rcParams["patch.force_edgecolor"] должен быть True для этого. 'face': Используется цвет смежной грани. Цвет matplotlib или последовательность цветов зададут цвет границы. Также используется синоним edgecolor. alpha : scalar, optional, default: None Значение альфа-смешивания цвета заливки, от 0 (прозрачный) до 1 (непрозрачный). Примечание: цвет границы в настоящее время не зависит от этого. snap : bool, optional, default: False Привязать сетку к границам пикселей.

Возвращает:

collection : matplotlib.collections.Collection

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

antialiaseds : bool, 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 последовательность из 2 чисел с плавающей точкой; может быть переопределён в методах, имеющих vmin и vmax параметры. clip_box Bbox clip_on bool clip_path [(Path, Transform) | Patch | None] cmap цветовая карта или зарегистрированное имя цветовой карты 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 offset_position {'screen', 'data'} offsets число с плавающей точкой или последовательность чисел с плавающей точкой path_effects AbstractPathEffect picker None или bool или float или вызываемая функция pickradius неизвестно rasterized bool или None sketch_params (масштаб: float, длина: float, случайность: 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.

Обработка граничных случаев 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

Приближение и отдаление с помощью Axes.margins и тема "прилипания"