Annotation
Les annotations sont des outils précieux pour mettre en lumière des points clés ou des zones spécifiques dans un graphique. Elles permettent d’ajouter des informations textuelles directement sur la visualisation, facilitant ainsi la compréhension et l’interprétation des données.
Avec Matplotlib, vous pouvez ajouter des annotations précises, positionner du texte, dessiner des flèches, et personnaliser leur style (couleur, taille, police) pour attirer l’attention sur des éléments importants comme des pics, des tendances ou des valeurs aberrantes.
Cette section vous expliquera comment intégrer efficacement des annotations dans vos graphiques afin de rendre vos analyses plus explicites et percutantes.
Fonctions :
-
plt.text()
La fonction plt.text() permet d'ajouter du texte à une position spécifique sur le graphique, sans flèche ni annotation particulière. C'est un moyen simple d'ajouter du texte explicatif ou des labels dans un graphique.
Importation :
import matplotlib.pyplot as plt
Attributs :
Paramètre Type Description Valeur par défaut x
float Position en x où placer le texte. None
y
float Position en y où placer le texte. None
text
str Le texte à afficher. None
fontsize
float Taille de la police du texte. 12
color
str Couleur du texte (ex : 'red', 'blue'). 'black'
Exemple de code :
import matplotlib.pyplot as plt # Tracer un graphique simple x = [1, 2, 3, 4] y = [1, 4, 9, 16] plt.plot(x, y) # Ajouter du texte à une position spécifique plt.text(2, 10, 'Texte à (2, 10)', fontsize=12, color='blue') # Afficher le graphique plt.show()
Explication du code :
import matplotlib.pyplot as plt
importe la bibliothèque matplotlib.pyplot, renommée ici enplt
pour simplifier son utilisation.Tracer un graphique simple
La variable
x
contient les abscisses des points à tracer.La variable
y
contient les ordonnées correspondantes, représentant une fonction quadratique.plt.plot(x, y)
trace la courbe définie par les points(x, y)
.Ajouter du texte à une position spécifique
La fonction
plt.text()
permet d'ajouter une annotation textuelle sur le graphique.Les deux premiers paramètres
2
et10
définissent la position du texte dans le repère (x=2, y=10).Le paramètre
'Texte à (2, 10)'
est le contenu du texte affiché.fontsize=12
définit la taille de la police du texte.color='blue'
applique une couleur bleue au texte.Afficher le graphique
La fonction
plt.show()
affiche le graphique avec la courbe et le texte ajouté. -
plt.annotate()
La fonction plt.annotate() permet d'ajouter une annotation textuelle à un graphique. Cette fonction est utilisée pour marquer un point spécifique dans un graphique avec du texte, une flèche, ou d'autres éléments graphiques, afin de fournir des informations supplémentaires sur des points ou des régions d'intérêt.
Importation :
import matplotlib.pyplot as plt
Attributs :
Paramètre Type Description Valeur par défaut text
str Le texte de l'annotation à afficher. None
xy
tuple Les coordonnées (x, y) du point à annoter. None
xytext
tuple Les coordonnées où placer le texte de l'annotation. None
arrowprops
dict Propriétés de la flèche, comme la couleur, la largeur et le style. None
fontsize
float Taille de la police de l'annotation. 12
Exemple de code :
import matplotlib.pyplot as plt # Tracer un graphique simple x = [1, 2, 3, 4] y = [1, 4, 9, 16] plt.plot(x, y) # Ajouter une annotation plt.annotate('Point important', xy=(2, 4), xytext=(3, 10), arrowprops=dict(facecolor='red', shrink=0.05), fontsize=14) # Afficher le graphique plt.show()
Explication du code :
import matplotlib.pyplot as plt
importe la bibliothèque matplotlib.pyplot, renommée ici enplt
pour simplifier son utilisation.Tracer un graphique simple
La variable
x
contient les abscisses des points à tracer.La variable
y
contient les ordonnées correspondantes, représentant ici une fonction quadratique.plt.plot(x, y)
trace la courbe formée par les points(x, y)
.Ajouter une annotation
La fonction
plt.annotate()
permet d'ajouter une annotation avec une flèche sur le graphique.Le texte
'Point important'
est le contenu de l’annotation.Le paramètre
xy=(2, 4)
désigne le point de données ciblé par l’annotation.xytext=(3, 10)
déplace le texte de l’annotation à la position (3, 10).arrowprops=dict(facecolor='red', shrink=0.05)
définit les propriétés de la flèche, ici avec une couleur rouge et une taille légèrement réduite.fontsize=14
ajuste la taille du texte de l’annotation.Afficher le graphique
La fonction
plt.show()
affiche le graphique avec la courbe et l’annotation visuelle.