matplotlib.pyplot.contourf

matplotlib.pyplot.contourf(*args, data=None, **kwargs) [source]

Строит контурные области.

Вызов:

contour([X, Y,] Z, [levels], **kwargs)

contour и contourf соответственно рисуют контурные линии и заполненные контурные области. За исключением отмеченных случаев, сигнатуры функций и возвращаемые значения одинаковы для обоих версий.

Параметры:	X, Yarray-like, optional Координаты значений в Z. X и Y должны быть двумерными с той же формой, что и Z (например, созданными с помощью numpy.meshgrid), или они оба должны быть одномерными, так что len(X) == M — количество столбцов в Z, а len(Y) == N — количество строк в Z. Если не указаны, предполагаются целочисленные индексы, т.е. X = range(M), Y = range(N). Zarray-like(N, M) Значения высот, по которым строится контур. levelsint or array-like, optional Определяет количество и положение линий/областей контура. Если целое число n, используется MaxNLocator, который пытается автоматически выбрать не более n+1 "приемлемых" уровней контура между vmin и vmax. Если массив, рисует контурные линии на указанных уровнях. Значения должны быть в порядке возрастания.
Возвращает:	QuadContourSet
Другие параметры:	corner_maskbool, default: rcParams["contour.corner_mask"] (default: True) Включает/выключает маскирование углов, что имеет эффект только если Z является массивной маской. Если False, любая четверть, касающаяся замаскированной точки, маскируется. Если True, только треугольные углы четвертей, ближайших к этим точкам, всегда маскируются, а другие треугольные углы, состоящие из трех незамаскированных точек, контурируются как обычно. colorscolor string or sequence of colors, optional Цвета уровней, т.е. линии для contour и области для contourf. Последовательность циклируется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется. В качестве сокращения, можно использовать строковые цвета вместо списков из одного элемента, т.е. 'red' вместо ['red'] для окраски всех уровней одним цветом. Это сокращение работает только для строк цвета, а не для других способов задания цветов. По умолчанию (значение None) используется цветовая карта, указанная в cmap. alphafloat, default: 1 Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis') Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта отображает значения уровней в цвета. Если заданы и colors, и cmap, возникает ошибка. normNormalize, optional Если используется цветовая карта, экземпляр Normalize масштабирует значения уровней до канонического диапазона цветовой карты [0, 1] для отображения в цвета. Если не указано, используется линейное масштабирование по умолчанию. vmin, vmaxfloat, optional Если не None, эти значения будут переданы экземпляру Normalize, переопределяя масштабирование цветов по умолчанию, основанное на levels. origin{None, 'upper', 'lower', 'image'}, default: None Определяет ориентацию и точное положение Z, указав положение Z[0, 0]. Это актуально только если X, Y не заданы. None: Z[0, 0] находится в левом нижнем углу при X=0, Y=0. 'lower': Z[0, 0] находится в левом нижнем углу при X=0.5, Y=0.5. 'upper': Z[0, 0] находится в левом верхнем углу при X=N+0.5, Y=0.5. 'image': Используйте значение из rcParams["image.origin"] (по умолчанию: 'upper'). extent(x0, x1, y0, y1), optional Если origin не None, то extent интерпретируется как в imshow: он задает внешние границы пикселей. В этом случае положение Z[0, 0] — центр пикселя, а не угол. Если origin — None, то (x0, y0) — положение Z[0, 0], а (x1, y1) — положение Z[-1, -1]. Этот аргумент игнорируется, если X и Y указаны в вызове contour. locatorticker.Locator subclass, optional Локатор используется для определения уровней контура, если они не заданы явно через levels. По умолчанию MaxNLocator. extend{'neither', 'both', 'min', 'max'}, default: 'neither' Определяет contourf-окраску значений, которые находятся за пределами диапазона levels. Если 'neither', значения за пределами диапазона levels не окрашиваются. Если 'min', 'max' или 'both', окрашиваются значения ниже, выше или ниже и выше диапазона levels. Значения ниже min(levels) и выше max(levels) отображаются в под/над значениях Colormap. Обратите внимание, что большинство цветовых карт по умолчанию не имеют выделенных цветов для этих значений, поэтому под/над значениями являются крайними значениями цветовой карты. Возможно, вам нужно явно задать эти значения, используя Colormap.set_under и Colormap.set_over. Примечание Существующий QuadContourSet не уведомляется, если изменяются свойства его цветовой карты. Поэтому необходимо выполнить явный вызов QuadContourSet.changed() после изменения цветовой карты. Явный вызов можно опустить, если цветовая шкала назначена QuadContourSet, так как он внутренне вызывает QuadContourSet.changed(). Пример: x = np.arange(1, 10) y = x.reshape(-1, 1) h = x * y cs = plt.contourf(h, levels=[10, 30, 50], colors=['#808080', '#A0A0A0', '#C0C0C0'], extend='both') cs.cmap.set_over('red') cs.cmap.set_under('blue') cs.changed() xunits, yunitsregistered units, optional Переопределить единицы осей, указав экземпляр matplotlib.units.ConversionInterface. antialiasedbool, optional Включить сглаживание, переопределив значения по умолчанию. Для заполненных контуров значение по умолчанию — True. Для контурных линий оно берётся из rcParams["lines.antialiased"] (по умолчанию: True). nchunkint >= 0, optional Если 0, нет разделения области. Укажите положительное целое число, чтобы разделить область на поддомены nchunk на nchunk четвертей. Разбиение уменьшает максимальную длину полигонов, генерируемых алгоритмом контурирования, что уменьшает нагрузку на рендеринг, передаваемую бэкенду, а также требует немного меньше оперативной памяти. Однако это может привести к артефактам рендеринга на границах фрагментов в зависимости от бэкенда, флага antialiased и значения alpha. linewidthsfloat or array-like, default: rcParams["contour.linewidth"] (default: None) Применимо только к contour. Толщина линии контурных линий. Если число, все уровни будут нарисованы с этой толщиной линии. Если последовательность, уровни в порядке возрастания будут нарисованы с толщинами линий в указанном порядке. Если None, это ссылается на rcParams["lines.linewidth"] (по умолчанию: 1.5). linestyles{None, 'solid', 'dashed', 'dashdot', 'dotted'}, optional Применимо только к contour. Если linestyles — None, по умолчанию 'solid', за исключением монохромных линий. В этом случае отрицательные контуры будут использовать стиль линии из rcParams["contour.negative_linestyle"] (по умолчанию: 'dashed'). linestyles также может быть итерируемым списком вышеуказанных строк, определяющих набор стилей линий, которые будут использоваться. Если этот итерируемый список короче, чем количество уровней контура, он будет повторяться по мере необходимости. hatchesList[str], optional Применимо только к contourf. Список узоров штриховки для использования в заполненных областях. Если None, штриховка к контуру не будет добавлена. Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкендах.

Примечания

1. contourf отличается от версии MATLAB тем, что не рисует грани многоугольников. Чтобы нарисовать грани, добавьте линии контуров с помощью вызовов contour.

2. contourf заполняет интервалы, которые закрыты сверху; то есть для границ z1 и z2 заполненная область имеет вид:

   z1 < Z <= z2
   

   за исключением нижнего интервала, который закрыт с обеих сторон (т.е. он включает самое низкое значение).

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

Маска углов контура

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

Штриховка контуров

Contourf и логарифмическая шкала цветов

Диаграмма контура неравномерно расположенных данных

pcolormesh

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