matplotlib.pyplot.pcolor

matplotlib.pyplot.pcolor(*args, **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’, края не будут видны. Значение mpl цвета или последовательность цветов установит цвет края. 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 число с плавающей точкой или None animated [True | False] antialiased или antialiaseds Булево значение или последовательность булевых значений array неизвестно clim последовательность из двух чисел с плавающей точкой 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 или dashes или linestyles [‘сплошная’ | ‘штриховая’, ‘штрихпунктирная’, ‘пунктирная’ | (смещение, последовательность включений-выключений штриха) | '-' | '--' | '-.' | ':' | '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>]:

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

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

Простые примеры анимации

Сохранение анимации