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()
    Résultat du code

    Explication du code :

    import matplotlib.pyplot as plt importe la bibliothèque matplotlib.pyplot, renommée ici en plt 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 et 10 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()
    Résultat du code

    Explication du code :

    import matplotlib.pyplot as plt importe la bibliothèque matplotlib.pyplot, renommée ici en plt 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.