matplotlib.axes.Axes.pcolor

Axes.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 функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив float (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 строка str hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout bool joinstyle {'miter', 'round', 'bevel'} label объект linestyle {'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...} linewidth число с плавающей точкой или последовательность чисел с плавающей точкой norm Normalize offset_position {'screen', 'data'} offsets число с плавающей точкой или последовательность чисел с плавающей точкой path_effects AbstractPathEffect picker None или bool или число с плавающей точкой или вызываемый объект pickradius неизвестно rasterized bool или None sketch_params (масштаб: float, длина: float, случайность: float) snap bool или None transform Transform url строка str 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.axes.Axes.pcolor

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

Масштабирование в и из с помощью Axes.margins и тема «прилипание»