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

Параметры:

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 или 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 или число с плавающей точкой или вызываемый объект 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.axes.Axes.pcolor

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

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