Fonction text() / annotate() de Matplotlib


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ètreDescription
x, yCoordonnées de position du texte
sLa chaîne de texte à afficher
fontsizeTaille de police
colorCouleur du texte
ha / horizontalalignmentAlignement horizontal : 'center', 'right', 'left'
va / verticalalignmentAlignement vertical : 'center', 'top', 'bottom', 'baseline'
rotationAngle de rotation (degrés)
fontweightGraisse de police : 'normal', 'bold', 'light'
bboxProprié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ètreDescription
textContenu du texte d'annotation
xyCoordonnées du point cible vers lequel on pointe (x, y) (pointe de la flèche)
xytextCoordonnées de la position de placement du texte. Par défaut, None (le texte est placé à la position xy)
xycoords / textcoordsSystème de coordonnées de xy / xytext : 'data', 'axes fraction', 'figure fraction', 'offset points', etc.
arrowpropsDictionnaire 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

StyleEffet
'->'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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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='-&gt;',
                            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 matplotlib.pyplot as plt
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.


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

Autres extensions