Функция contour() / contourf() в 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, Y | 2D массивоподобный объект или 1D массив | x и y координаты точек сетки. Если переданы 1D массивы, они автоматически разворачиваются с помощью meshgrid |
| Z | 2D массивоподобный объект | Значение функции (высота) в каждой точке сетки, той же формы, что X, Y |
| levels | int или массивоподобный объект | Уровни контуров: целое число означает автоматическую генерацию N уровней, массив означает конкретные значения уровней |
| colors | color или list | Цвет контуров (для contour) |
| cmap | str или Colormap | Colormap (для contourf), например, 'viridis', 'terrain' |
| альфа | float | Прозрачность 0-1 |
| linewidths | float или list | Ширина линии (для contour) |
| linestyles | str или list | Стиль линии (для contour), например, 'solid', 'dashed' |
| extend | str | Обработка цветов вне диапазона уровней: 'neither'/'both'/'min'/'max' |
| antialiased | bool | Включать ли сглаживание (для contourf), по умолчанию True |
clabel() Дополнительные примечания
clabel()Используется для добавления подписей значений на контурных линиях.
Axes.clabel(CS, levels=None, **kwargs)
Примеры использования
Пример 1: Сравнение базового контурного графика и заполненного контурного графика
Пример
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 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 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.
Другие расширения