matplotlib.pyplot.pcolormesh

matplotlib.pyplot.pcolormesh(*args, **kwargs)

Построение сетки из четырёхугольников.

Возможные варианты вызова:

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

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

pcolormesh похож на pcolor(), но использует другой механизм и возвращает другой объект; pcolor возвращает PolyCollection, а pcolormesh — QuadMesh. Он значительно быстрее, поэтому его почти всегда предпочтительнее использовать для больших массивов.

Массив C может быть массивом с пропусками, но X и Y — нет. Поддержка массивов с пропусками реализована с помощью cmap и norm; в отличие от pcolor(), который просто не отрисовывает четырёхугольники с пропущенными цветами или вершинами.

Ключевые аргументы:

cmap: [ None | Colormap ]

Объект matplotlib.colors.Colormap. Если None, используется значение по умолчанию из настроек rc.

norm: [ None | Normalize ]

Объект matplotlib.colors.Normalize используется для масштабирования данных яркости до диапазона 0,1. Если None, по умолчанию используется normalize().

vmin/vmax: [ None | скаляр ]

vmin и vmax используются вместе с norm для нормализации данных яркости. Если какой-либо из них равен None, масштабирование выполняется автоматически до минимального и максимального значений массива цветов C. Если они не равны None, значения vmin или vmax переопределяют любые значения, заданные в объекте norm.

shading: [ ‘flat’ | ‘gouraud’ ]

‘flat’ означает использование одного цвета для каждого четырёхугольника. При ‘gouraud’ каждый четырёхугольник будет затенён с помощью интерполяции Гуро. При затенении Гуро параметр edgecolors игнорируется.

edgecolors: [None | 'None' | 'face' | color |

последовательность цветов]

Если None, используется значение по умолчанию из настроек rc.

Если 'None', границы не будут видны.

Если 'face', границы будут иметь тот же цвет, что и грани.

Значение mpl цвета или последовательности цветов задаёт цвет границ

alpha: 0 <= scalar <= 1 or None

значение альфа-смешивания

Возвращаемый объект — matplotlib.collections.QuadMesh.

Аргументы kwargs можно использовать для управления свойствами matplotlib.collections.QuadMesh:

Свойство	Описание
`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` или штрихи или стили линий	[‘сплошная’ \| ‘пунктирная’, ‘пунктирная с точками’, ‘точковая’ \| (смещение, последовательность вкл/выкл) \| `'-'` \| `'--'` \| `'-.'` \| `':'` \| `'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`	любое число

См. также

pcolor(): Для объяснения ориентации сетки (Ориентация сетки) и расширения одномерных массивов X и/или Y до двумерных.

Примечание

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

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