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 должны быть обеих 2-мерными с такой же формой, как 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, используйте n интервалов данных; т.е. постройте n+1 линий контура. Уровни высоты выбираются автоматически. Если массив, постройте линии контура на указанных уровнях. Значения должны быть упорядочены по возрастанию.
Возвращаемые значения:	cQuadContourSet
Другие параметры:	corner_maskbool, optional Включить/выключить маскирование углов, которое влияет только в том случае, если Z является массивкой с пропускаемыми значениями. Если False, любой четырехугольник, касающийся пропущенной точки, маскируется. Если True, маскируются только треугольные углы четырехугольников, ближайшие к этим точкам, а другие треугольные углы, состоящие из трех не пропущенных точек, отображаются как обычно. По умолчанию rcParams["contour.corner_mask"] (по умолчанию: True). colorscolor string or sequence of colors, optional Цвета уровней, т.е. линии для contour и области для contourf. Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче числа уровней, она повторяется. В качестве сокращения могут использоваться строковые значения цвета вместо списков с одним элементом, т.е. 'red' вместо ['red'] для окраски всех уровней одним цветом. Это сокращение работает только для строковых значений цвета, а не для других способов указания цветов. По умолчанию (значение None) используется цветовая карта, указанная с помощью cmap. alphafloat, optional Значение прозрачности, от 0 (прозрачный) до 1 (непрозрачный). cmapstr or Colormap, optional Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровней цветам. По умолчанию rcParams["image.cmap"] (по умолчанию: 'viridis'). Если заданы и colors, и cmap, возникает ошибка. normNormalize, optional Если используется цветовая карта, экземпляр Normalize масштабирует значения уровней до канонического диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не задано, используется линейное масштабирование по умолчанию. vmin, vmaxfloat, optional Если не None, эти значения будут переданы экземпляру Normalize, переопределяя масштабирование цвета по умолчанию на основе levels. origin{None, 'upper', 'lower', 'image'}, optional Определяет ориентацию и точное положение 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'}, optional, default: 'neither' Определяет окраску значений, которые находятся вне диапазона 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 sequence of float, optional Применимо только к contour. Толщина линий контура. Если число, все уровни будут отображаться с этой толщиной. Если последовательность, уровни в порядке возрастания будут отображаться с толщинами в указанном порядке. По умолчанию 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