matplotlib.axes.Axes.contourf

Axes.contourf(self, *args, data=None, **kwargs) [source]

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

Вызов:

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

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

Параметры:	X, Y : array-like, optional Координаты значений в Z. X и Y должны быть двумерными с той же формой, что и Z (например, созданные с помощью numpy.meshgrid), или они должны быть одномерными, так что len(X) == M является числом столбцов в Z, а len(Y) == N является числом строк в Z. Если не указаны, они предполагаются целочисленными индексами, т.е. X = range(M), Y = range(N). Z : array-like(N, M) Значения высот, по которым строится контур. levels : int or array-like, optional Определяет количество и позиции контурных линий/областей. Если целое число n, используется n интервалов данных; т.е. строятся n+1 контурных линий. Значения уровней выбираются автоматически. Если массив, строятся контурные линии на заданных уровнях. Значения должны быть в порядке возрастания.
Возвращаемое значение:	c : QuadContourSet
Другие параметры:	corner_mask : bool, optional Включает/выключает маскирование углов, что имеет эффект только если Z является массивом с маской. Если False, любая четверть, касающаяся маскированного значения, маскируется. Если True, только треугольные углы четвертей, ближайших к этим значениям, всегда маскируются, другие треугольные углы, состоящие из трёх не маскированных значений, отображаются обычным образом. По умолчанию rcParams["contour.corner_mask"], которое по умолчанию True. colors : color string or sequence of colors, optional Цвета уровней, т.е. линии для contour и области для contourf. Последовательность циклически применяется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется. В качестве сокращения можно использовать одиночные строковые значения цвета вместо списков с одним элементом, например, 'red' вместо ['red'] для окраски всех уровней одним цветом. Это сокращение работает только для строковых значений цвета, а не для других способов задания цветов. По умолчанию (значение None) используется цветовая карта, заданная параметром cmap. alpha : float, optional Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). cmap : str or Colormap, optional Объект Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровней с цветами. По умолчанию rcParams["image.cmap"]. Если задано, colors имеет приоритет над cmap. norm : Normalize, optional Если используется цветовая карта, объект Normalize масштабирует значения уровней до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не указано, используется линейное масштабирование по умолчанию. vmin, vmax : float, 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"]. 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. locator : ticker.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, yunits : registered units, optional Переопределяет единицы осей, указав экземпляр matplotlib.units.ConversionInterface. antialiased : bool, optional Включает/выключает сглаживание, переопределяя настройки по умолчанию. Для заполненных контуров значение по умолчанию True. Для контурных линий оно берётся из rcParams["lines.antialiased"]. Nchunk : int >= 0, optional Если 0, разбиение области не производится. Укажите положительное целое число для деления области на поддомены размером nchunk на nchunk квадрантов. Разбиение уменьшает максимальную длину полигонов, генерируемых алгоритмом контурирования, что уменьшает нагрузку на бэкэнд и требует немного меньше оперативной памяти. Однако оно может вводить артефакты рендеринга на границах поддоменов в зависимости от бэкэнда, флага antialiased и значения alpha. linewidths : float or sequence of float, optional Применимо только к contour. Ширина линий контурных линий. Если число, все уровни будут нарисованы с этой шириной. Если последовательность, уровни в порядке возрастания будут нарисованы с указанными ширинами. По умолчанию rcParams["lines.linewidth"]. linestyles : {None, 'solid', 'dashed', 'dashdot', 'dotted'}, optional Применимо только к contour. Если linestyles — None, значение по умолчанию 'solid', если линии не монохромные. В противном случае, контуры с отрицательными значениями будут использовать стиль линии из rcParams["contour.negative_linestyle"] настройки. linestyles также может быть итерируемым списком вышеуказанных строк, задающих набор стилей линий, которые будут использоваться. Если этот список короче, чем количество контурных уровней, он будет повторяться по мере необходимости. hatches : List[str], optional Применимо только к contourf. Список схем штриховки, которые будут использоваться в заполненных областях. Если None, штриховка не будет добавлена к контуру. Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкэндах.

Примечания

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

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

   z1 < Z <= z2
   

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

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

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

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

Раскраска контуров с узорами

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

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

pcolormesh

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