Функция Matplotlib subplots()
Справочная документация Matplotlib
subplots()Это рекомендуемый способ создать Figure и набор подграфиков Axes, завершая создание холста и подграфиков одним вызовом.
Это основная входная функция объектно-ориентированного интерфейса Matplotlib.
Определение функции
Интерфейс pyplot
matplotlib.pyplot.subplots(nrows=1, ncols=1, *, sharex=False,
sharey=False, squeeze=True, width_ratios=None,
height_ratios=None, subplot_kw=None, gridspec_kw=None,
**fig_kw)
Метод Figure
Figure.subplots(nrows=1, ncols=1, *, sharex=False, sharey=False,
squeeze=True, width_ratios=None, height_ratios=None,
subplot_kw=None, gridspec_kw=None)
Описание параметра
| Параметр | Type | Описание |
|---|---|---|
| nrows | int | Количество строк подграфиков, по умолчанию 1 |
| ncols | int | Количество столбцов подграфиков, по умолчанию 1 |
| sharex / sharey | bool или str | Использовать ли общие оси x/y. Можно передать 'all'/'row'/'col'/'none' или логические значения |
| squeeze | bool | Если True, автоматически удаляет лишние измерения для одной строки/столбца, по умолчанию True |
| width_ratios | list | Соотношение ширины каждого столбца, например, [1, 2] означает, что столбец 2 в 2 раза шире столбца 1 |
| height_ratios | list | Соотношение высоты каждой строки, например, [2, 1] означает, что строка 1 в 2 раза выше строки 2 |
| subplot_kw | dict | Параметры, передаваемые при создании подграфика, например dict(projection='polar') для создания полярного подграфика |
| gridspec_kw | dict | Параметры, передаваемые в GridSpec, например dict(hspace=0.3, wspace=0.3) для настройки расстояния между подграфиками |
| **fig_kw | dict | Параметры, передаваемые при создании Figure, например figsize=(8,6), dpi=100, layout='constrained' |
Возвращаемое значение subplots() — это кортеж
(fig, ax)Если имеется только одна строка и один столбец, ax — это единственный объект Axes; при нескольких строках и столбцах ax — это двумерный массив объектов Axes.
Примеры использования
Пример 1: один подграфик
Пример
import numpy as np
# Создать один подграфик (наиболее распространённый вариант использования)
fig, ax = plt.subplots(figsize=(6, 4), layout='constrained')
x = np.linspace(0, 10, 100)
ax.plot(x, np.sin(x))
ax.set_title('Один подграфик')
ax.set_xlabel('x')
ax.set_ylabel('sin(x)')
ax.grid(True, alpha=0.3)
plt.show()
Пример 2: одна строка, несколько столбцов / один столбец, несколько строк
Пример
import numpy as np
x = np.linspace(0, 10, 100)
# Одна строка, три столбца
fig, axes = plt.subplots(1, 3, figsize=(12, 4),
layout='constrained')
# axes — это одномерный массив
axes[0].plot(x, np.sin(x), color='blue')
axes[0].set_title('sin(x)')
axes[1].plot(x, np.cos(x), color='red')
axes[1].set_title('cos(x)')
axes[2].plot(x, np.tan(x), color='green')
axes[2].set_title('tan(x)')
axes[2].set_ylim(-5, 5) # Ограничить диапазон y
for ax in axes:
ax.set_xlabel('x')
ax.grid(True, alpha=0.3)
fig.suptitle('Три подграфика в одной строке', fontsize=14)
plt.show()
Пример 3: сетка 2x2 + соотношения ширины/высоты
Пример
import numpy as np
# Соотношение сторон: строка 1 выше, столбец 2 шире
fig, axes = plt.subplots(2, 2,
figsize=(10, 8),
width_ratios=[1, 2], # Ширина столбца 2 в 2 раза больше ширины столбца 1
height_ratios=[2, 1], # Высота строки 1 в 2 раза больше высоты строки 2
layout='constrained',
sharex='col', # Каждый столбец использует общую ось x
sharey='row') # Каждая строка использует общую ось y
x = np.linspace(0, 10, 100)
# axes — двумерный массив, axes[row, col]
axes[0, 0].plot(x, np.sin(x))
axes[0, 0].set_title('sin(x)')
axes[0, 1].plot(x, np.cos(x), 'orange')
axes[0, 1].set_title('cos(x)')
axes[1, 0].plot(x, np.sin(2*x), 'green')
axes[1, 0].set_title('sin(2x)')
axes[1, 1].plot(x, np.cos(2*x), 'red')
axes[1, 1].set_title('cos(2x)')
fig.suptitle('Сетка 2x2 с соотношениями ширины/высоты', fontsize=14)
plt.show()
Пример 4: общие оси sharex и sharey
Пример
import numpy as np
np.random.seed(42)
# Общая ось X для удобного сравнения временных рядов
fig, axes = plt.subplots(3, 1, figsize=(8, 6),
sharex=True, # Общая ось X
layout='constrained')
t = np.linspace(0, 20, 200)
# Три подграфика имеют общую ось X, выровнены по одним и тем же моментам времени
axes[0].plot(t, np.sin(t), 'blue')
axes[0].set_ylabel('Сигнал 1')
axes[0].grid(True, alpha=0.3)
axes[1].plot(t, np.cos(t * 1.5), 'green')
axes[1].set_ylabel('Сигнал 2')
axes[1].grid(True, alpha=0.3)
axes[2].plot(t, np.sin(t * 0.7) + np.cos(t * 1.3), 'red')
axes[2].set_xlabel('Время (s)')
axes[2].set_ylabel('Сигнал 3')
axes[2].grid(True, alpha=0.3)
fig.suptitle('Общая ось X: три временных ряда', fontsize=14)
plt.show()
Пример 5: Полярный подграфик
Пример
import numpy as np
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
subplot_kw={'projection': 'polar'}, # Оба используют полярные координаты
layout='constrained')
theta = np.linspace(0, 2 * np.pi, 100)
# Левый график: кривая-роза
r1 = np.abs(np.sin(3 * theta))
ax1.plot(theta, r1, color='blue', linewidth=2)
ax1.set_title('Полярный: кривая-роза (r=|sin(3θ)|)')
# Правый график: архимедова спираль
r2 = theta / 6
ax2.plot(theta, r2, color='red', linewidth=2)
ax2.set_title('Полярный: архимедова спираль')
plt.show()
Часто задаваемые вопросы
Что делает параметр squeeze?
squeeze=TrueКогда (по умолчанию):subplots(1,1)возвращаетax(not [ax]),subplots(1,3)возвращает 1D-массив.
squeeze=FalseКогда, он всегда возвращает 2D-массив (независимо от количества строк/столбцов), подходящий для сценариев, требующих унифицированной обработки.
В чём разница между subplot_kw и gridspec_kw?
subplot_kwПередаётся в каждую функцию создания Axes, напримерprojection='polar'。
gridspec_kwПередаётся менеджеру компоновки GridSpec, напримерhspace=0.4(вертикальный интервал между подграфиками).
Другие расширения