matplotlib.axes.Axes.pcolor

Axes.pcolor(*args, data=None, **kwargs) [source]

Создать псевдоцветной график с нерегулярной прямоугольной сеткой.

Вызов:

pcolor([X, Y,] C, **kwargs)

X и Y могут быть использованы для указания углов четырехугольников.

Подсказка

pcolor() может быть очень медленным для больших массивов. В большинстве случаев вы должны использовать аналогичную, но намного более быструю функцию pcolormesh вместо неё. См. там обсуждение различий.

Параметры:

C : array_like Массив скаляров 2D. Значения будут отображаться в цветовой шкале. 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, подходящие значения min/max автоматически выбираются экземпляром Normalize (по умолчанию это соответственно min/max значения 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 или antialiaseds Булево значение или последовательность булевых значений array массив ndarray capstyle неизвестно clim последовательность из двух чисел с плавающей точкой; может быть переопределена в методах, имеющих vmin и vmax в качестве аргументов. clip_box экземпляр Bbox clip_on bool clip_path [(Path, Transform) | Patch | None] cmap колористическая карта или зарегистрированное имя колористической карты color аргумент цвета matplotlib или последовательность кортежей rgba contains вызываемая функция edgecolor или edgecolors спецификация цвета matplotlib или последовательность спецификаций facecolor или facecolors спецификация цвета matplotlib или последовательность спецификаций figure экземпляр Figure gid строка идентификатора hatch ['/' | '\' | '|' | '-' | '+' | 'x' | 'o' | 'O' | '.' | '*'] joinstyle неизвестно label объект linestyle или dashes или linestyles ['сплошная' | 'штриховая', 'штрихпунктирная', 'пунктирная' | (смещение, последовательность включения-выключения-штриха) | '-' | '--' | '-.' | ':' | 'None' | ' ' | ''] linewidth или linewidths или lw число с плавающей точкой или последовательность чисел с плавающей точкой norm Normalize offset_position [ 'экран' | 'данные' ] offsets число с плавающей точкой или последовательность чисел с плавающей точкой path_effects AbstractPathEffect picker [None | bool | float | вызываемая функция] pickradius расстояние в точках rasterized bool или None sketch_params (масштаб: float, длина: float, случайность: float) snap bool или None transform Transform url строка 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>]:

• Все позиционные и все ключевые аргументы.

Примеры использования matplotlib.axes.Axes.pcolor

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