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-D. Значения будут отображаться в цветовой шкале. 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 — одномерные массивы или столбцы, они будут расширены до необходимых двумерных массивов, образуя прямоугольную сетку. 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': Используется цвет прилегающей грани. Цвета mpl или последовательность цветов установят цвет границ. Одиночная форма 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 функция фильтра, которая принимает (m, n, 3) массив с плавающей точкой и значение dpi и возвращает (m, n, 3) массив alpha float или None animated bool antialiased 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 аргумент цвета matplotlib или последовательность кортежей rgba contains вызываемый объект edgecolor цвет или последовательность цветов facecolor цвет или последовательность цветов figure Figure gid строка hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout bool joinstyle {'miter', 'round', 'bevel'} label объект linestyle {'-', '--', '-.', ':', '', (offset, on-off-seq), ...} linewidth число с плавающей точкой или последовательность чисел с плавающей точкой norm Normalize offset_position {'screen', 'data'} offsets число с плавающей точкой или последовательность чисел с плавающей точкой path_effects AbstractPathEffect picker None или bool или число с плавающей точкой или вызываемый объект pickradius неизвестно rasterized bool или None sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) 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.

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