Fonctions de gestion des figures et des axes de Matplotlib
Documentation de référence de Matplotlib
Matplotlib fournit une série de fonctions pour créer et gérer des objets Figure et Axes. Toutes les fonctions associées sont listées ci-dessous.
Liste des fonctions
| Fonction | Description | pyplot | Méthode correspondante |
|---|---|---|---|
| figure() | Créer ou activer une Figure | plt.figure() | - |
| subplots() | Créer une Figure et une grille d'Axes | plt.subplots() | fig.subplots() |
| subplot() | Ajouter un sous-graphique unique par index de ligne et de colonne | plt.subplot() | fig.add_subplot() |
| subplot2grid() | Créer un sous-graphique à une position spécifiée dans la grille | plt.subplot2grid() | - |
| subplot_mosaic() | Disposer les sous-graphiques avec des chaînes d'étiquettes | plt.subplot_mosaic() | fig.subplot_mosaic() |
| axes() | Ajouter un Axes à la Figure actuelle | plt.axes() | fig.add_axes() |
| gca() | Obtenir les Axes actuels | plt.gca() | fig.gca() |
| gcf() | Obtenir la Figure actuelle | plt.gcf() | - |
| sca() | Définir les Axes actuels | plt.sca(ax) | fig.sca(ax) |
| cla() | Effacer les Axes actuels | plt.cla() | ax.cla() |
| clf() | Effacer la Figure actuelle | plt.clf() | fig.clear() |
| close() | Fermer la fenêtre de la Figure | plt.close() | - |
| delaxes() | Supprimer les Axes d'une Figure | plt.delaxes(ax) | fig.delaxes(ax) |
| fignum_exists() | Vérifier si un numéro de Figure existe | plt.fignum_exists(n) | - |
| get_figlabels() | Obtenir une liste de toutes les étiquettes de Figure | plt.get_figlabels() | - |
| get_fignums() | Obtenir une liste de tous les numéros de Figure | plt.get_fignums() | - |
| twinx() | Créer un axe y jumeau partageant l'axe des x | plt.twinx() | ax.twinx() |
| twiny() | Créer un axe x jumeau partageant l'axe y | plt.twiny() | ax.twiny() |
Exemples d'utilisation
Exemple 1 : gca/gcf/sca opérant sur la figure courante
Exemple
import matplotlib.pyplot as plt
import numpy as np
x = np.linspace(0, 10, 100)
# Créer la première Figure
plt.figure(1)
plt.plot(x, np.sin(x), label='sin(x)')
# Créer la deuxième Figure
plt.figure(2)
plt.plot(x, np.cos(x), label='cos(x)')
# Vérifier si la figure 1 existe
print(plt.fignum_exists(1)) # True
# Obtenir tous les numéros de figure
print(plt.get_fignums()) # [1, 2]
# Revenir à la figure 1
plt.figure(1)
ax = plt.gca() # Obtenir les axes actuels
print(ax.get_title())
# Définir les axes actuels sur un autre
plt.sca(ax)
plt.title('Basculé via sca()')
plt.show()
import numpy as np
x = np.linspace(0, 10, 100)
# Créer la première Figure
plt.figure(1)
plt.plot(x, np.sin(x), label='sin(x)')
# Créer la deuxième Figure
plt.figure(2)
plt.plot(x, np.cos(x), label='cos(x)')
# Vérifier si la figure 1 existe
print(plt.fignum_exists(1)) # True
# Obtenir tous les numéros de figure
print(plt.get_fignums()) # [1, 2]
# Revenir à la figure 1
plt.figure(1)
ax = plt.gca() # Obtenir les axes actuels
print(ax.get_title())
# Définir les axes actuels sur un autre
plt.sca(ax)
plt.title('Basculé via sca()')
plt.show()
True [1, 2]
Exemple 2 : Création d'une disposition non uniforme avec subplot2grid
Exemple
import matplotlib.pyplot as plt
import numpy as np
fig = plt.figure(figsize=(10, 6), layout='constrained')
# subplot2grid(shape, loc, rowspan, colspan)
# shape=(3,3): une grille de 3 lignes et 3 colonnes
ax1 = plt.subplot2grid((3, 3), (0, 0), colspan=3) # La partie supérieure s'étend sur toute la ligne
ax2 = plt.subplot2grid((3, 3), (1, 0), rowspan=2) # La partie gauche s'étend verticalement sur 2 lignes
ax3 = plt.subplot2grid((3, 3), (1, 1), colspan=2) # La partie en haut à droite s'étend sur 2 colonnes
ax4 = plt.subplot2grid((3, 3), (2, 1)) # Milieu droit
ax5 = plt.subplot2grid((3, 3), (2, 2)) # En bas à droite
x = np.linspace(0, 10, 50)
ax1.plot(x, np.sin(x))
ax1.set_title('Haut : colspan=3')
ax2.plot(x, np.cos(x), 'orange')
ax2.set_title('Gauche : rowspan=2')
ax3.bar(['A','B','C'], [3,7,5])
ax3.set_title('En haut à droite : colspan=2')
ax4.text(0.5, 0.5, 'Panneau 4', ha='center', va='center')
ax5.text(0.5, 0.5, 'Panneau 5', ha='center', va='center')
fig.suptitle('Disposition subplot2grid', fontsize=14)
plt.show()
import numpy as np
fig = plt.figure(figsize=(10, 6), layout='constrained')
# subplot2grid(shape, loc, rowspan, colspan)
# shape=(3,3): une grille de 3 lignes et 3 colonnes
ax1 = plt.subplot2grid((3, 3), (0, 0), colspan=3) # La partie supérieure s'étend sur toute la ligne
ax2 = plt.subplot2grid((3, 3), (1, 0), rowspan=2) # La partie gauche s'étend verticalement sur 2 lignes
ax3 = plt.subplot2grid((3, 3), (1, 1), colspan=2) # La partie en haut à droite s'étend sur 2 colonnes
ax4 = plt.subplot2grid((3, 3), (2, 1)) # Milieu droit
ax5 = plt.subplot2grid((3, 3), (2, 2)) # En bas à droite
x = np.linspace(0, 10, 50)
ax1.plot(x, np.sin(x))
ax1.set_title('Haut : colspan=3')
ax2.plot(x, np.cos(x), 'orange')
ax2.set_title('Gauche : rowspan=2')
ax3.bar(['A','B','C'], [3,7,5])
ax3.set_title('En haut à droite : colspan=2')
ax4.text(0.5, 0.5, 'Panneau 4', ha='center', va='center')
ax5.text(0.5, 0.5, 'Panneau 5', ha='center', va='center')
fig.suptitle('Disposition subplot2grid', fontsize=14)
plt.show()
Exemple 3 : disposition des étiquettes subplot_mosaic
Exemple
import matplotlib.pyplot as plt
import numpy as np
layout = """
AAAB
CCDD
"""
fig, axes = plt.subplot_mosaic(layout, figsize=(10, 6),
layout='constrained')
x = np.linspace(0, 10, 100)
# Accéder aux sous-graphiques par nom d'étiquette
axes['A'].plot(x, np.sin(x))
axes['A'].set_title('A : Panneau large supérieur')
axes['B'].plot(x, np.cos(x), 'orange')
axes['B'].set_title('B : En haut à droite')
axes['C'].bar(['X','Y','Z'], [5, 8, 3], color='steelblue')
axes['C'].set_title('C : En bas à gauche')
axes['D'].hist(np.random.randn(200), bins=20,
color='coral', edgecolor='white')
axes['D'].set_title('D : En bas à droite')
fig.suptitle('subplot_mosaic() avec accès par étiquette')
plt.show()
import numpy as np
layout = """
AAAB
CCDD
"""
fig, axes = plt.subplot_mosaic(layout, figsize=(10, 6),
layout='constrained')
x = np.linspace(0, 10, 100)
# Accéder aux sous-graphiques par nom d'étiquette
axes['A'].plot(x, np.sin(x))
axes['A'].set_title('A : Panneau large supérieur')
axes['B'].plot(x, np.cos(x), 'orange')
axes['B'].set_title('B : En haut à droite')
axes['C'].bar(['X','Y','Z'], [5, 8, 3], color='steelblue')
axes['C'].set_title('C : En bas à gauche')
axes['D'].hist(np.random.randn(200), bins=20,
color='coral', edgecolor='white')
axes['D'].set_title('D : En bas à droite')
fig.suptitle('subplot_mosaic() avec accès par étiquette')
plt.show()
Exemple 4 : twinx/twiny axes doubles
Exemple
import matplotlib.pyplot as plt
import numpy as np
x = np.linspace(0, 10, 100)
fig, ax1 = plt.subplots(figsize=(8, 4), layout='constrained')
# Axe y principal (côté gauche)
color1 = 'tab:blue'
ax1.plot(x, np.sin(x) * 100, color=color1, label='Tension')
ax1.set_xlabel('Temps (s)')
ax1.set_ylabel('Tension (mV)', color=color1)
ax1.tick_params(axis='y', labelcolor=color1)
# twinx() crée un axe y jumeau partageant l'axe x (côté droit)
ax2 = ax1.twinx()
color2 = 'tab:red'
ax2.plot(x, np.cos(x) * 40 + 50, color=color2, linestyle='--',
label='Température')
ax2.set_ylabel('Température (°C)', color=color2)
ax2.tick_params(axis='y', labelcolor=color2)
ax1.set_title('Double axe Y avec twinx()')
plt.show()
import numpy as np
x = np.linspace(0, 10, 100)
fig, ax1 = plt.subplots(figsize=(8, 4), layout='constrained')
# Axe y principal (côté gauche)
color1 = 'tab:blue'
ax1.plot(x, np.sin(x) * 100, color=color1, label='Tension')
ax1.set_xlabel('Temps (s)')
ax1.set_ylabel('Tension (mV)', color=color1)
ax1.tick_params(axis='y', labelcolor=color1)
# twinx() crée un axe y jumeau partageant l'axe x (côté droit)
ax2 = ax1.twinx()
color2 = 'tab:red'
ax2.plot(x, np.cos(x) * 40 + 50, color=color2, linestyle='--',
label='Température')
ax2.set_ylabel('Température (°C)', color=color2)
ax2.tick_params(axis='y', labelcolor=color2)
ax1.set_title('Double axe Y avec twinx()')
plt.show()
Exemple 5 : opérations de nettoyage cla/clf/close
Exemple
import matplotlib.pyplot as plt
import numpy as np
# Créer une Figure et tracer
fig, ax = plt.subplots()
ax.plot([1, 2, 3], [4, 5, 6])
ax.set_title('Graphique original')
print('Avant cla() :', len(ax.get_lines())) # 1
# cla() efface le contenu des Axes (conserve les Axes et la Figure)
ax.cla()
print('Après cla() :', len(ax.get_lines())) # 0
# Tracer à nouveau
ax.plot([1, 2, 3], [1, 4, 9])
ax.set_title('Après cla() et nouveau tracé')
plt.show()
# clf() efface toute la Figure
plt.clf()
print('Après clf() :', len(fig.get_axes())) # 0
# close() ferme la fenêtre de la Figure
plt.close('all')
print('exemple : nettoyage terminé')
import numpy as np
# Créer une Figure et tracer
fig, ax = plt.subplots()
ax.plot([1, 2, 3], [4, 5, 6])
ax.set_title('Graphique original')
print('Avant cla() :', len(ax.get_lines())) # 1
# cla() efface le contenu des Axes (conserve les Axes et la Figure)
ax.cla()
print('Après cla() :', len(ax.get_lines())) # 0
# Tracer à nouveau
ax.plot([1, 2, 3], [1, 4, 9])
ax.set_title('Après cla() et nouveau tracé')
plt.show()
# clf() efface toute la Figure
plt.clf()
print('Après clf() :', len(fig.get_axes())) # 0
# close() ferme la fenêtre de la Figure
plt.close('all')
print('exemple : nettoyage terminé')
Autres extensions