Fonction text() / annotate() de Matplotlib
Documentation de référence de Matplotlib
text()Ajouter du texte aux coordonnées spécifiées dans le graphique,annotate()Ajouter des annotations avec des flèches, qui peuvent pointer précisément vers des points de données.
Définition de fonction
text()
matplotlib.pyplot.text(x, y, s, fontdict=None, **kwargs) Axes.text(x, y, s, fontdict=None, **kwargs)
annotate()
matplotlib.pyplot.annotate(text, xy, xytext=None, xycoords='data',
textcoords=None, arrowprops=None, annotation_clip=None, **kwargs)
Axes.annotate(text, xy, xytext=None, xycoords='data',
textcoords=None, arrowprops=None, annotation_clip=None, **kwargs)
Description du paramètre
Paramètres de text()
| Paramètre | Description |
|---|---|
| x, y | Coordonnées de position du texte |
| s | La chaîne de texte à afficher |
| fontsize | Taille de police |
| color | Couleur du texte |
| ha / horizontalalignment | Alignement horizontal : 'center', 'right', 'left' |
| va / verticalalignment | Alignement vertical : 'center', 'top', 'bottom', 'baseline' |
| rotation | Angle de rotation (degrés) |
| fontweight | Graisse de police : 'normal', 'bold', 'light' |
| bbox | Propriétés de la boîte d'arrière-plan du texte, par ex., dict(facecolor='yellow', alpha=0.5) |
Paramètres spécifiques de annotate()
| Paramètre | Description |
|---|---|
| text | Contenu du texte d'annotation |
| xy | Coordonnées du point cible vers lequel on pointe (x, y) (pointe de la flèche) |
| xytext | Coordonnées de la position de placement du texte. Par défaut, None (le texte est placé à la position xy) |
| xycoords / textcoords | Système de coordonnées de xy / xytext : 'data', 'axes fraction', 'figure fraction', 'offset points', etc. |
| arrowprops | Dictionnaire de propriétés de la flèche, par ex. dict(arrowstyle='->', color='gray', lw=1.5) |
L'intérêt principal d'annotate réside dans le fait que xy et xytext peuvent spécifier séparément le point de coordonnées et la position du texte, et relier les deux par une flèche, ce que text() ne permet pas de faire.
Styles de flèches courants d'arrowprops
| Style | Effet |
|---|---|
| '->' | Flèche à triangle plein |
| '-' | Aucune ligne |
| '<->' | Flèche à double pointe |
| '-[widthB=...,lengthB=...]' | Flèche rectangulaire personnalisée |
| 'fancy' | Flèche courbe élégante |
| 'simple' | Flèche droite simple |
Exemples d'utilisation
Exemple 1 : Ajout de texte de base (text)
Exemple
import numpy as np
x = np.linspace(0, 10, 100)
y = np.sin(x)
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
ax.plot(x, y, 'steelblue', linewidth=2)
# Ajouter une étiquette de texte au sommet
peak_idx = np.argmax(y)
ax.text(x[peak_idx], y[peak_idx] + 0.1,
f'Pic: ({x[peak_idx]:.2f}, {y[peak_idx]:.2f})',
fontsize=10, color='red',
ha='center', va='bottom',
fontweight='bold')
# Ajouter du texte + une boîte d'arrière-plan à la vallée
valley_idx = np.argmin(y)
ax.text(x[valley_idx], y[valley_idx] - 0.15,
f'Vallée : ({x[valley_idx]:.2f}, {y[valley_idx]:.2f})',
fontsize=10, ha='center', va='top',
bbox=dict(boxstyle='round,pad=0.3',
facecolor='yellow', alpha=0.7))
ax.set_title('text() - Ajout de texte à des coordonnées spécifiques')
ax.set_xlabel('x')
ax.set_ylabel('sin(x)')
ax.grid(True, alpha=0.3)
plt.show()
Exemple 2 : Annotation avec flèche (annotate)
Exemple
import numpy as np
x = np.linspace(0, 10, 50)
y = np.exp(-x/3) * np.sin(2 * x) # Oscillation amortie
fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')
ax.plot(x, y, 'steelblue', linewidth=2, marker='o', markersize=4)
# Annoter le premier pic (la flèche pointe du texte vers le point de données)
peak1_idx = np.argmax(y)
ax.annotate('1er pic',
xy=(x[peak1_idx], y[peak1_idx]), # Le point vers lequel pointe la flèche
xytext=(x[peak1_idx] + 1.5, y[peak1_idx] + 0.2), # Position du texte
arrowprops=dict(arrowstyle='->',
color='red', lw=1.5),
fontsize=11, color='red', fontweight='bold')
# Annoter la région de décroissance
ax.annotate('Région de décroissance',
xy=(.7, .3), xycoords='axes fraction', # Utiliser les coordonnées des axes
xytext=(0.5, 0.8), textcoords='axes fraction',
arrowprops=dict(arrowstyle='fancy',
color='green',
connectionstyle='arc3,rad=0.3'),
fontsize=11, color='green',
bbox=dict(boxstyle='round', facecolor='wheat', alpha=0.5))
ax.set_title('annotate() - Annotations avec flèches')
ax.set_xlabel('Temps (s)')
ax.set_ylabel('Amplitude')
ax.grid(True, alpha=0.3)
plt.show()
Exemple 3 : Annotation de formule et système de coordonnées
Exemple
import numpy as np
x = np.linspace(0, 4*np.pi, 200)
y1 = np.sin(x)
y2 = np.cos(x)
fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')
ax.plot(x, y1, 'blue', label='sin(x)')
ax.plot(x, y2, 'red', label='cos(x)')
# Annoter avec une formule mathématique à une position fixe dans le graphique
ax.text(0.02, 0.95,
r'$f(x) = sin(x)$',
transform=ax.transAxes, # Utiliser des coordonnées relatives aux axes (0-1)
fontsize=14, color='blue',
verticalalignment='top',
bbox=dict(boxstyle='round', facecolor='lightblue', alpha=0.5))
ax.text(0.02, 0.82,
r'$g(x) = cos(x)$',
transform=ax.transAxes,
fontsize=14, color='red',
verticalalignment='top',
bbox=dict(boxstyle='round', facecolor='lightcoral', alpha=0.5))
ax.set_title(r'Formule mathématique avec LaTeX : $sum_{i=1}^{n} x_i$')
ax.set_xlabel('x (radians)')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
print("exemple : annotation mathématique affichée")
FAQ
Quelle est la différence entre text et annotate ?
text()Place uniquement du texte aux coordonnées spécifiées, ce qui convient pour ajouter des étiquettes ou des descriptions.
annotate()Peut ajouter une flèche reliant le texte et le point de données, ce qui convient pour annoter précisément des positions clés.
Comment utiliser des formules mathématiques dans le texte ?
Utilisez la syntaxe LaTeX :r'$alpha + beta$'Le préfixe r indique une chaîne brute, et le contenu à l'intérieur de $...$ sera rendu sous forme de formule mathématique.
Nécessite que LaTeX soit installé sur le système, ou utilisez le moteur de rendu mathtext intégré de Matplotlib.
Autres extensions