Fonctions de texte et d'annotation au niveau de la figure de Matplotlib
Documentation de référence de Matplotlib
En plus de text() et annotate(), Matplotlib fournit également des fonctions de texte au niveau de la figure, l'ajout de tableaux et le tracé de flèches.
Aperçu des fonctions
| Fonction | Description |
|---|---|
| figtext() | Ajouter du texte au niveau de la Figure (pas des Axes) |
| figlegend() | Ajouter une légende au niveau de la Figure (sur plusieurs Axes) |
| table() | Ajouter un tableau aux Axes |
| arrow() | Ajouter une flèche simple |
figtext() - Texte au niveau de la figure
matplotlib.pyplot.figtext(x, y, s, fontdict=None, **kwargs)
Similaire à text(), mais le système de coordonnées est celui de la figure (0-1), pas les coordonnées des données.
Exemple
import matplotlib.pyplot as plt
import numpy as np
fig, ax = plt.subplots(figsize=(8, 5))
ax.plot([0, 1], [0, 1], 'steelblue')
ax.set_title('Niveau des axes (text vs figtext)')
# Texte au niveau des axes (coordonnées des données)
ax.text(0.3, 0.7, 'Texte des axes (coordonnées des données)',
fontsize=12, color='blue')
# Texte au niveau de la figure (coordonnées relatives à la figure 0-1)
plt.figtext(0.5, 0.02,
'Texte de la figure en bas au centre (coordonnées de la figure)',
ha='center', fontsize=10, color='gray')
plt.figtext(0.02, 0.95,
'En haut à gauche',
ha='left', va='top',
fontsize=12, fontweight='bold', color='red')
plt.show()
import numpy as np
fig, ax = plt.subplots(figsize=(8, 5))
ax.plot([0, 1], [0, 1], 'steelblue')
ax.set_title('Niveau des axes (text vs figtext)')
# Texte au niveau des axes (coordonnées des données)
ax.text(0.3, 0.7, 'Texte des axes (coordonnées des données)',
fontsize=12, color='blue')
# Texte au niveau de la figure (coordonnées relatives à la figure 0-1)
plt.figtext(0.5, 0.02,
'Texte de la figure en bas au centre (coordonnées de la figure)',
ha='center', fontsize=10, color='gray')
plt.figtext(0.02, 0.95,
'En haut à gauche',
ha='left', va='top',
fontsize=12, fontweight='bold', color='red')
plt.show()
figlegend() - Légende au niveau de la Figure
matplotlib.pyplot.figlegend(*args, **kwargs)
Lorsque plusieurs Axes doivent partager une légende, figlegend() peut placer la légende au niveau de la Figure.
Exemple
import matplotlib.pyplot as plt
import numpy as np
x = np.linspace(0, 10, 100)
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
layout='constrained')
# Tracez les deux mêmes courbes sur chaque Axes, mais n'ajoutez pas de légendes distinctes
ax1.plot(x, np.sin(x), 'b-', label='sin(x)')
ax1.plot(x, np.cos(x), 'r--', label='cos(x)')
ax1.set_title('Graphique 1')
ax2.plot(x, np.sin(x), 'b-', label='sin(x)')
ax2.plot(x, np.cos(x), 'r--', label='cos(x)')
ax2.set_title('Graphique 2')
# Légende au niveau de la Figure (placée en haut à l'extérieur de la Figure)
fig.legend(loc='outside upper center', ncol=2,
fontsize=11, frameon=True)
plt.show()
import numpy as np
x = np.linspace(0, 10, 100)
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
layout='constrained')
# Tracez les deux mêmes courbes sur chaque Axes, mais n'ajoutez pas de légendes distinctes
ax1.plot(x, np.sin(x), 'b-', label='sin(x)')
ax1.plot(x, np.cos(x), 'r--', label='cos(x)')
ax1.set_title('Graphique 1')
ax2.plot(x, np.sin(x), 'b-', label='sin(x)')
ax2.plot(x, np.cos(x), 'r--', label='cos(x)')
ax2.set_title('Graphique 2')
# Légende au niveau de la Figure (placée en haut à l'extérieur de la Figure)
fig.legend(loc='outside upper center', ncol=2,
fontsize=11, frameon=True)
plt.show()
table() - Ajouter un tableau aux Axes
matplotlib.pyplot.table(cellText=None, cellColours=None,
cellLoc='right', colWidths=None, rowLabels=None,
rowColours=None, rowLoc='left', colLabels=None,
colColours=None, colLoc='center', loc='bottom',
bbox=None, edges='closed', **kwargs)
Exemple
import matplotlib.pyplot as plt
import numpy as np
# Données à afficher
data = [[85, 90, 78, 92],
[76, 88, 82, 85],
[90, 93, 88, 95]]
row_labels = ['Étudiant A', 'Étudiant B', 'Étudiant C']
col_labels = ['Maths', 'Anglais', 'Sciences', 'Histoire']
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
# Tracer un graphique comparatif
x = np.arange(len(col_labels))
for i, (row, label) in enumerate(zip(data, row_labels)):
ax.plot(x, row, 'o-', label=label, markersize=8)
ax.set_xticks(x)
ax.set_xticklabels(col_labels)
ax.set_title('Scores des étudiants')
ax.legend()
ax.grid(True, alpha=0.3)
# Ajouter un tableau sous le graphique
table = ax.table(cellText=data,
rowLabels=row_labels,
colLabels=col_labels,
cellLoc='center',
loc='bottom',
bbox=[0, -0.35, 1, 0.25]) # [gauche, bas, largeur, hauteur]
plt.show()
import numpy as np
# Données à afficher
data = [[85, 90, 78, 92],
[76, 88, 82, 85],
[90, 93, 88, 95]]
row_labels = ['Étudiant A', 'Étudiant B', 'Étudiant C']
col_labels = ['Maths', 'Anglais', 'Sciences', 'Histoire']
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
# Tracer un graphique comparatif
x = np.arange(len(col_labels))
for i, (row, label) in enumerate(zip(data, row_labels)):
ax.plot(x, row, 'o-', label=label, markersize=8)
ax.set_xticks(x)
ax.set_xticklabels(col_labels)
ax.set_title('Scores des étudiants')
ax.legend()
ax.grid(True, alpha=0.3)
# Ajouter un tableau sous le graphique
table = ax.table(cellText=data,
rowLabels=row_labels,
colLabels=col_labels,
cellLoc='center',
loc='bottom',
bbox=[0, -0.35, 1, 0.25]) # [gauche, bas, largeur, hauteur]
plt.show()
arrow() - Ajouter une flèche
matplotlib.pyplot.arrow(x, y, dx, dy, **kwargs)
arrow() est un raccourci pour ajouter des flèches simples. Pour les annotations de flèches complexes, annotate() est recommandé.
Exemple
import matplotlib.pyplot as plt
import numpy as np
fig, ax = plt.subplots(figsize=(7, 5), layout='constrained')
# Tracer un système de coordonnées
ax.spines[['left', 'bottom']].set_position(('data', 0))
ax.spines[['top', 'right']].set_visible(False)
ax.set_xlim(-1, 5)
ax.set_ylim(-1, 5)
# Différentes flèches
ax.arrow(0, 0, 3, 0, head_width=0.2, head_length=0.2,
fc='red', ec='red', label='3 unités vers la droite')
ax.arrow(0, 0, 0, 3, head_width=0.2, head_length=0.2,
fc='blue', ec='blue', label='3 unités vers le haut')
ax.arrow(0, 0, 2, 2, head_width=0.2, head_length=0.2,
fc='green', ec='green', label='Diagonale')
ax.set_title('arrow() - Flèches simples')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
import numpy as np
fig, ax = plt.subplots(figsize=(7, 5), layout='constrained')
# Tracer un système de coordonnées
ax.spines[['left', 'bottom']].set_position(('data', 0))
ax.spines[['top', 'right']].set_visible(False)
ax.set_xlim(-1, 5)
ax.set_ylim(-1, 5)
# Différentes flèches
ax.arrow(0, 0, 3, 0, head_width=0.2, head_length=0.2,
fc='red', ec='red', label='3 unités vers la droite')
ax.arrow(0, 0, 0, 3, head_width=0.2, head_length=0.2,
fc='blue', ec='blue', label='3 unités vers le haut')
ax.arrow(0, 0, 2, 2, head_width=0.2, head_length=0.2,
fc='green', ec='green', label='Diagonale')
ax.set_title('arrow() - Flèches simples')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
Autres extensions