matplotlib.pyplot.pcolor

matplotlib.pyplot.pcolor(*args, **kwargs) [source]

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

Вызов:

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

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

Подсказка

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

Параметры:

C : array_like Скалярный 2-мерный массив. Значения будут отображаться в цветах. 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 являются 1-мерными массивами или столбцами, они будут расширены в нужные 2-мерные массивы, образуя прямоугольную сетку. 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': Используется цвет смежной грани. Мпл цвет или последовательность цветов установят цвет границ. Единичная форма 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 функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi, и возвращает массив (m, n, 3) alpha число с плавающей точкой или None animated булево значение antialiased или antialiaseds Булево значение или последовательность булевых значений array массив ndarray capstyle неизвестно clim последовательность из двух чисел с плавающей точкой; может быть переопределена в методах, имеющих vmin и vmax аргументы. clip_box экземпляр Bbox clip_on булево значение 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 | булево значение | число с плавающей точкой | функция-вызов] pickradius расстояние в пунктах rasterized булево значение или None sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) snap булево значение или None transform Transform url строка url urls Список строк или None visible булево значение 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>]:

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

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

Демонстрация pcolor