matplotlib.axes.Axes.pcolor

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

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

Подписи вызова:

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

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

Параметры:	C : array_like Массив значений цвета. X, Y : array_like, необязательно Если заданы, указывают (x, y) координаты цветных четырехугольников; четырехугольник для C[i,j] имеет углы: (X[i, j], Y[i, j]), (X[i, j+1], Y[i, j+1]), (X[i+1, j], Y[i+1, j]), (X[i+1, j+1], Y[i+1, j+1]) В идеале размерности X и Y должны быть на единицу больше, чем размерности C; если размерности одинаковы, то последняя строка и столбец C будут игнорироваться. Обратите внимание, что индекс столбца соответствует координате x, а индекс строки — координате y; подробности см. в разделе Ориентация сетки ниже. Если X или Y являются одномерными массивами или столбцами, они будут расширены по мере необходимости до соответствующих двумерных массивов, образуя прямоугольную сетку. cmap : Colormap, необязательно, по умолчанию: None Если None, по умолчанию используется значение rc. norm : matplotlib.colors.Normalize, необязательно, по умолчанию: None Объект используется для масштабирования данных яркости до (0, 1). Если None, по умолчанию используется normalize(). vmin, vmax : скаляр, необязательно, по умолчанию: None vmin и vmax используются совместно с norm для нормализации данных яркости. Если либо равно None, то происходит автоматическое масштабирование до минимального или максимального значения массива цветов C. Если не None, vmin или vmax переданные здесь переопределяют любые предварительно заданные значения, переданные в экземпляре norm. edgecolors : {None, ‘none’, цвет, последовательность цветов} Если None, используется значение rc по умолчанию. Если ‘none’, края не будут видны. Мпл цвет или последовательность цветов установит цвет края. alpha : скаляр, необязательно, по умолчанию: None Значение смешивания альфа-канала, от 0 (прозрачный) до 1 (непрозрачный). snap : bool, необязательно, по умолчанию: 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 неизвестно alpha float или None animated [True | False] antialiased или antialiaseds Булево значение или последовательность булевых значений array неизвестно clim последовательность из 2 чисел с плавающей точкой clip_box экземпляр matplotlib.transforms.Bbox clip_on [True | False] clip_path [ (Path, Transform) | Patch | None ] cmap цветовая карта или зарегистрированное имя цветовой карты color matplotlib цветовой аргумент или последовательность rgba кортежей contains вызываемая функция edgecolor или edgecolors matplotlib цветовое значение или последовательность цветовых значений facecolor или facecolors matplotlib цветовое значение или последовательность цветовых значений figure экземпляр matplotlib.figure.Figure gid строка идентификатора hatch [‘/’ | ‘' | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ] label строка или что-либо печатное с преобразованием ‘%s’ linestyle или штрихи или стили линий [‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (смещение, последовательность включения-выключения штрихов) | '-' | '--' | '-.' | ':' | 'None' | ' ' | ''] linewidth или linewidths или lw число с плавающей точкой или последовательность чисел с плавающей точкой norm неизвестно offset_position неизвестно offsets число с плавающей точкой или последовательность чисел с плавающей точкой path_effects неизвестно picker [None|число с плавающей точкой|булево значение|вызываемая функция] pickradius неизвестно rasterized [True | False | None] sketch_params неизвестно snap неизвестно transform экземпляр Transform url строка url urls неизвестно visible [True | False] zorder любое число

См. также

pcolormesh

для объяснения различий между pcolor и pcolormesh.

Примечания

X, Y и C могут быть массивами с пропусками. Если C[i, j] или один из вершин, окружающих C[i,j] (X или Y в [i, j], [i+1, j], [i, j+1], [i+1, j+1]) имеют пропуск, то ничего не рисуется.

Ориентация сетки соответствует соглашению MATLAB: массив C формы (nrows, ncolumns) изображается с номером столбца как X и номером строки как Y, возрастающим вверх; следовательно, он изображается так, как массив был бы напечатан, за исключением того, что ось Y инвертирована. То есть C воспринимается как C (y, x).

Аналогично для meshgrid():

x = np.arange(5)
y = np.arange(3)
X, Y = np.meshgrid(x, y)

эквивалентно:

X = array([[0, 1, 2, 3, 4],
           [0, 1, 2, 3, 4],
           [0, 1, 2, 3, 4]])

Y = array([[0, 0, 0, 0, 0],
           [1, 1, 1, 1, 1],
           [2, 2, 2, 2, 2]])

поэтому, если у вас есть:

C = rand(len(x), len(y))

то вам нужно транспонировать C:

pcolor(X, Y, C.T)

или:

pcolor(C.T)

MATLAB pcolor() всегда отбрасывает последнюю строку и столбец C, но Matplotlib отображает последнюю строку и столбец, если X и Y не указаны или если X и Y имеют на одну строку и столбец больше, чем C.

Примечание

В дополнение к описанным выше аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

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