Fonction subplots() de 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ètre | Type | Description |
|---|---|---|
| nrows | int | Nombre de lignes de sous-graphiques, par défaut 1 |
| ncols | int | Nombre de colonnes de sous-graphiques, par défaut 1 |
| sharex / sharey | bool ou str | Indique si les axes x/y doivent être partagés. Peut prendre 'all'/'row'/'col'/'none' ou des valeurs booléennes |
| squeeze | bool | Si True, supprime automatiquement les dimensions supplémentaires pour une seule ligne/colonne, par défaut True |
| width_ratios | liste | Rapport de largeur de chaque colonne, p. ex., [1, 2] signifie que la colonne 2 est 2 fois plus large que la colonne 1 |
| height_ratios | liste | Rapport de hauteur de chaque ligne, p. ex., [2, 1] signifie que la ligne 1 est 2 fois plus haute que la ligne 2 |
| subplot_kw | dict | Paramètres transmis à la création de sous-graphiques, par ex. dict(projection='polar') pour créer un sous-graphique polaire |
| gridspec_kw | dict | Paramètres transmis à GridSpec, par ex. dict(hspace=0.3, wspace=0.3) pour définir l'espacement des sous-graphiques |
| **fig_kw | dict | Paramè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 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 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 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 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 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).
Autres extensions