matplotlib.axes.Axes.pcolor

Axes.pcolor(self, *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, подходящие минимальные/максимальные значения автоматически выбираются экземпляром Normalize (по умолчанию соответствуют минимальным/максимальным значениям 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 функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3) alpha число с плавающей точкой или None animated логическое значение antialiased или aa или antialiaseds логическое значение или последовательность логических значений array массив ndarray capstyle {'butt', 'round', 'projecting'} clim (vmin: число с плавающей точкой, vmax: число с плавающей точкой) clip_box Bbox clip_on логическое значение clip_path Patch или (Path, Transform) или None cmap палитра цветов или зарегистрированное имя палитры цветов color цвет или последовательность кортежей rgba contains вызываемая функция edgecolor или ec или edgecolors цвет или последовательность цветов или 'face' facecolor или facecolors или fc цвет или последовательность цветов figure Figure gid строка hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout логическое значение joinstyle {'miter', 'round', 'bevel'} label объект linestyle или dashes или linestyles или ls {'-', '--', '-.', ':', '', (смещение, последовательность включений-выключений), ...} linewidth или linewidths или lw число с плавающей точкой или последовательность чисел с плавающей точкой norm Normalize offset_position {'screen', 'data'} offsets массивоподобный объект (N, 2) или (2,) path_effects AbstractPathEffect picker None или логическое значение или число с плавающей точкой или вызываемая функция pickradius неизвестно rasterized логическое значение или None sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) snap логическое значение или None transform Transform url строка urls список строк или None visible логическое значение 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.

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

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

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