Функция Matplotlib subplots()


Matplotlib 参考文档Справочная документация 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Описание
nrowsintКоличество строк подграфиков, по умолчанию 1
ncolsintКоличество столбцов подграфиков, по умолчанию 1
sharex / shareybool или strИспользовать ли общие оси x/y. Можно передать 'all'/'row'/'col'/'none' или логические значения
squeezeboolЕсли True, автоматически удаляет лишние измерения для одной строки/столбца, по умолчанию True
width_ratioslistСоотношение ширины каждого столбца, например, [1, 2] означает, что столбец 2 в 2 раза шире столбца 1
height_ratioslistСоотношение высоты каждой строки, например, [2, 1] означает, что строка 1 в 2 раза выше строки 2
subplot_kwdictПараметры, передаваемые при создании подграфика, например dict(projection='polar') для создания полярного подграфика
gridspec_kwdictПараметры, передаваемые в GridSpec, например dict(hspace=0.3, wspace=0.3) для настройки расстояния между подграфиками
**fig_kwdictПараметры, передаваемые при создании Figure, например figsize=(8,6), dpi=100, layout='constrained'

Возвращаемое значение subplots() — это кортеж(fig, ax)Если имеется только одна строка и один столбец, ax — это единственный объект Axes; при нескольких строках и столбцах ax — это двумерный массив объектов Axes.


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

Пример 1: один подграфик

Пример

import matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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(вертикальный интервал между подграфиками).


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

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