Fonction subplots() de Matplotlib


Matplotlib 参考文档Documentation de référence de Matplotlib

subplots()C'est la façon recommandée de créer une Figure et un ensemble de sous-graphiques Axes, en complétant la création du canevas et des sous-graphiques en un seul appel.

C'est la fonction d'entrée principale de l'interface orientée objet de Matplotlib.

Définition de fonction

Interface 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)

Méthode de 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)

Description du paramètre

ParamètreTypeDescription
nrowsintNombre de lignes de sous-graphiques, par défaut 1
ncolsintNombre de colonnes de sous-graphiques, par défaut 1
sharex / shareybool ou strIndique si les axes x/y doivent être partagés. Peut prendre 'all'/'row'/'col'/'none' ou des valeurs booléennes
squeezeboolSi True, supprime automatiquement les dimensions supplémentaires pour une seule ligne/colonne, par défaut True
width_ratioslisteRapport de largeur de chaque colonne, p. ex., [1, 2] signifie que la colonne 2 est 2 fois plus large que la colonne 1
height_ratioslisteRapport de hauteur de chaque ligne, p. ex., [2, 1] signifie que la ligne 1 est 2 fois plus haute que la ligne 2
subplot_kwdictParamètres transmis à la création de sous-graphiques, par ex. dict(projection='polar') pour créer un sous-graphique polaire
gridspec_kwdictParamètres transmis à GridSpec, par ex. dict(hspace=0.3, wspace=0.3) pour définir l'espacement des sous-graphiques
**fig_kwdictParamètres transmis à la création de Figure, par ex. figsize=(8,6), dpi=100, layout='constrained'

La valeur de retour de subplots() est un tuple(fig, ax)Lorsqu'il n'y a qu'une seule ligne et une seule colonne, ax est un objet Axes unique ; avec plusieurs lignes et colonnes, ax est un tableau 2D d'objets Axes.


Exemples d'utilisation

Exemple 1 : Sous-graphique unique

Exemple

import matplotlib.pyplot as plt
import numpy as np

# Créer un sous-graphique unique (utilisation la plus courante)
fig, ax = plt.subplots(figsize=(6, 4), layout='constrained')

x = np.linspace(0, 10, 100)
ax.plot(x, np.sin(x))
ax.set_title('Sous-graphique unique')
ax.set_xlabel('x')
ax.set_ylabel('sin(x)')
ax.grid(True, alpha=0.3)
plt.show()

Exemple 2 : Une ligne, plusieurs colonnes / Une colonne, plusieurs lignes

Exemple

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 10, 100)

# Une ligne, trois colonnes
fig, axes = plt.subplots(1, 3, figsize=(12, 4),
                          layout='constrained')

# axes est un tableau 1D
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)  # Limiter la plage de y

for ax in axes:
    ax.set_xlabel('x')
    ax.grid(True, alpha=0.3)

fig.suptitle('Trois sous-graphiques sur une ligne', fontsize=14)
plt.show()

Exemple 3 : Grille 2x2 + ratios largeur/hauteur

Exemple

import matplotlib.pyplot as plt
import numpy as np

# Rapport d'aspect : la ligne 1 est plus haute, la colonne 2 est plus large
fig, axes = plt.subplots(2, 2,
                          figsize=(10, 8),
                          width_ratios=[1, 2],   # La largeur de la colonne 2 est 2 fois celle de la colonne 1
                          height_ratios=[2, 1],   # La hauteur de la ligne 1 est 2 fois celle de la ligne 2
                          layout='constrained',
                          sharex='col',           # Chaque colonne partage l'axe des x
                          sharey='row')           # Chaque ligne partage l'axe des y

x = np.linspace(0, 10, 100)

# axes est un tableau 2D, 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('Grille 2x2 avec ratios Largeur/Hauteur', fontsize=14)
plt.show()

Exemple 4 : axes partagés sharex et sharey

Exemple

import matplotlib.pyplot as plt
import numpy as np

np.random.seed(42)

# Partager l'axe des x pour faciliter la comparaison des séries temporelles
fig, axes = plt.subplots(3, 1, figsize=(8, 6),
                          sharex=True,            # Partager l'axe des x
                          layout='constrained')

t = np.linspace(0, 20, 200)

# Trois sous-graphiques partagent l'axe des x, alignés sur les mêmes points temporels
axes[0].plot(t, np.sin(t), 'blue')
axes[0].set_ylabel('Signal 1')
axes[0].grid(True, alpha=0.3)

axes[1].plot(t, np.cos(t * 1.5), 'green')
axes[1].set_ylabel('Signal 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('Temps (s)')
axes[2].set_ylabel('Signal 3')
axes[2].grid(True, alpha=0.3)

fig.suptitle('Axe des X partagé : trois séries temporelles', fontsize=14)
plt.show()

Exemple 5 : sous-graphique polaire

Exemple

import matplotlib.pyplot as plt
import numpy as np

fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
    subplot_kw={'projection': 'polar'},  # Les deux sont des coordonnées polaires
    layout='constrained')

theta = np.linspace(0, 2 * np.pi, 100)

# Graphique de gauche : courbe en rose
r1 = np.abs(np.sin(3 * theta))
ax1.plot(theta, r1, color='blue', linewidth=2)
ax1.set_title('Polaire : courbe en rose (r=|sin(3θ)|)')

# Graphique de droite : spirale d'Archimède
r2 = theta / 6
ax2.plot(theta, r2, color='red', linewidth=2)
ax2.set_title('Polaire : spirale d'Archimède')

plt.show()

Questions courantes

À quoi sert le paramètre squeeze ?

squeeze=TrueLorsque (par défaut) :subplots(1,1)renvoieax(sans [ax]),subplots(1,3)renvoie un tableau 1D.

squeeze=FalseLorsque c'est le cas, il renvoie toujours un tableau 2D (quel que soit le nombre de lignes/colonnes), adapté aux scénarios nécessitant un traitement unifié.

Quelle est la différence entre subplot_kw et gridspec_kw ?

subplot_kwTransmis à chaque fonction de création d'Axes, telle queprojection='polar'。

gridspec_kwTransmis au gestionnaire de mise en page GridSpec, tel quehspace=0.4(espacement vertical des subplots).


Matplotlib 参考文档Documentation de référence de Matplotlib

Autres extensions