Fonctions de gestion des figures et des axes de Matplotlib


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

FonctionDescriptionpyplotMéthode correspondante
figure()Créer ou activer une Figureplt.figure()-
subplots()Créer une Figure et une grille d'Axesplt.subplots()fig.subplots()
subplot()Ajouter un sous-graphique unique par index de ligne et de colonneplt.subplot()fig.add_subplot()
subplot2grid()Créer un sous-graphique à une position spécifiée dans la grilleplt.subplot2grid()-
subplot_mosaic()Disposer les sous-graphiques avec des chaînes d'étiquettesplt.subplot_mosaic()fig.subplot_mosaic()
axes()Ajouter un Axes à la Figure actuelleplt.axes()fig.add_axes()
gca()Obtenir les Axes actuelsplt.gca()fig.gca()
gcf()Obtenir la Figure actuelleplt.gcf()-
sca()Définir les Axes actuelsplt.sca(ax)fig.sca(ax)
cla()Effacer les Axes actuelsplt.cla()ax.cla()
clf()Effacer la Figure actuelleplt.clf()fig.clear()
close()Fermer la fenêtre de la Figureplt.close()-
delaxes()Supprimer les Axes d'une Figureplt.delaxes(ax)fig.delaxes(ax)
fignum_exists()Vérifier si un numéro de Figure existeplt.fignum_exists(n)-
get_figlabels()Obtenir une liste de toutes les étiquettes de Figureplt.get_figlabels()-
get_fignums()Obtenir une liste de tous les numéros de Figureplt.get_fignums()-
twinx()Créer un axe y jumeau partageant l'axe des xplt.twinx()ax.twinx()
twiny()Créer un axe x jumeau partageant l'axe yplt.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()
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()

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

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

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é')

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

Autres extensions