Функция contour() / contourf() в Matplotlib


Matplotlib 参考文档Справочная документация Matplotlib

contour()Рисовать контурные линии,contourf()Рисовать заполненные контуры.

Обе используются для визуализации двумерных скалярных полей (таких как карты рельефа, температурные поля, поля давления и т. д.).

Определение функции

Интерфейс pyplot

matplotlib.pyplot.contour(*args, **kwargs)
matplotlib.pyplot.contourf(*args, **kwargs)

Интерфейс Axes

Axes.contour(X, Y, Z, levels=None, **kwargs)
Axes.contourf(X, Y, Z, levels=None, **kwargs)

Описание параметра

ПараметрTypeОписание
X, Y2D массивоподобный объект или 1D массивx и y координаты точек сетки. Если переданы 1D массивы, они автоматически разворачиваются с помощью meshgrid
Z2D массивоподобный объектЗначение функции (высота) в каждой точке сетки, той же формы, что X, Y
levelsint или массивоподобный объектУровни контуров: целое число означает автоматическую генерацию N уровней, массив означает конкретные значения уровней
colorscolor или listЦвет контуров (для contour)
cmapstr или ColormapColormap (для contourf), например, 'viridis', 'terrain'
альфаfloatПрозрачность 0-1
linewidthsfloat или listШирина линии (для contour)
linestylesstr или listСтиль линии (для contour), например, 'solid', 'dashed'
extendstrОбработка цветов вне диапазона уровней: 'neither'/'both'/'min'/'max'
antialiasedboolВключать ли сглаживание (для contourf), по умолчанию True

clabel() Дополнительные примечания

clabel()Используется для добавления подписей значений на контурных линиях.

Axes.clabel(CS, levels=None, **kwargs)

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

Пример 1: Сравнение базового контурного графика и заполненного контурного графика

Пример

import matplotlib.pyplot as plt
import numpy as np

# Создать 2D-сетку и значения функции
x = np.linspace(-3, 3, 100)
y = np.linspace(-3, 3, 100)
X, Y = np.meshgrid(x, y)
Z = np.sin(X) * np.cos(Y)  # 2D-функция

fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(12, 5),
                                layout='constrained')

# Левый график: контурные линии (contour)
cs1 = ax1.contour(X, Y, Z, levels=10, cmap='viridis')
ax1.clabel(cs1, inline=True, fontsize=8)  # Добавить подписи
ax1.set_title('contour() - Линейные контуры')

# Правый график: заполненные контуры (contourf)
cs2 = ax2.contourf(X, Y, Z, levels=15, cmap='RdYlBu')
fig.colorbar(cs2, ax=ax2, label='Значение')
# Наложение граничных линий
ax2.contour(X, Y, Z, levels=15, colors='black', linewidths=0.3)
ax2.set_title('contourf() - Заполненные контуры')

for ax in [ax1, ax2]:
    ax.set_xlabel('X')
    ax.set_ylabel('Y')

plt.show()

Пример 2: Пользовательские уровни

Пример

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(-5, 5, 150)
y = np.linspace(-5, 5, 150)
X, Y = np.meshgrid(x, y)

# Гауссовы холмы
Z = np.exp(-((X-1)**2 + Y**2) / 4) +
    np.exp(-((X+1)**2 + Y**2) / 3)

fig, ax = plt.subplots(figsize=(7, 5), layout='constrained')

# Пользовательские уровни: от 0.1 до 1.0, интервал 0.1
custom_levels = np.arange(0.1, 1.1, 0.1)
cs = ax.contourf(X, Y, Z, levels=custom_levels,
                 cmap='YlOrRd', extend='both')
cbar = fig.colorbar(cs, ax=ax, label='Высота')

ax.contour(X, Y, Z, levels=custom_levels,
           colors='black', linewidths=0.5)

ax.set_title('Контур пользовательских уровней')
ax.set_xlabel('X')
ax.set_ylabel('Y')
plt.show()

Пример 3: Стиль карты рельефа (цветовая карта terrain)

Пример

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(-4, 4, 200)
y = np.linspace(-4, 4, 200)
X, Y = np.meshgrid(x, y)

# Моделирование рельефа: два пика + одна долина
Z = 3 * np.exp(-((X+2)**2 + Y**2) / 3) +
    2 * np.exp(-((X-1)**2 + (Y-1)**2) / 2) -
    1 * np.exp(-((X+0.5)**2 + (Y-2)**2) / 1.5)

fig, ax = plt.subplots(figsize=(8, 6), layout='constrained')

# Используйте палитру terrain для имитации карты рельефа
cs = ax.contourf(X, Y, Z, levels=20, cmap='terrain', extend='both')
fig.colorbar(cs, ax=ax, label='Высота', shrink=0.8)

ax.contour(X, Y, Z, levels=20, colors='black', linewidths=0.3,
           альфа=0.4)

ax.set_title('Контурная карта в стиле рельефа')
ax.set_xlabel('X (km)')
ax.set_ylabel('Y (km)')
plt.show()
print("пример: отображён контур рельефа")

Часто задаваемые вопросы

Когда использовать contour, а когда contourf?

contour()contour: подходит для просмотра четких граничных линий, таких как изобары.

contourf()contourf: подходит для отображения непрерывно изменяющихся полей, таких как распределение температуры.

Обычная практика — накладывать оба: contourf заполняет цвета, а contour накладывает граничные линии.

Должны ли X, Y быть 2D?

Нет. Если одномерные массивы переданы как X и Y, matplotlib автоматически вызоветnp.meshgrid(X, Y)meshgrid для создания 2D-сетки. Z должен соответствовать форме после meshgrid.


Matplotlib 参考文档Справочная документация Matplotlib

Другие расширения