HOWTO · Matplotlib

Comment ajouter un titre aux sous-parcelles dans Matplotlib

Nous pouvons ajouter un titre aux sous-graphiques dans Matplotlib en utilisant Axes.set_title(), Axes.title.set_text() ou les axes courants de pyplot (plt.gca()).

Sur cette page

Pour donner à chaque sous-graphique son propre titre, appelez Axes.set_title() sur les axes correspondants. C’est le choix le plus clair lorsque vous créez plusieurs graphiques à la fois, car chaque titre reste associé aux axes qu’il décrit. Le titre d’un sous-graphique s’applique à un seul objet Axes ; utilisez un titre de figure, comme fig.suptitle(), lorsqu’un même titre doit décrire toute la figure.

Ajouter un titre à chaque sous-graphique avec Axes.set_title()

Lorsque squeeze=False est défini, plt.subplots() renvoie une figure et un tableau d’axes. L’exemple ci-dessous trace quatre séries, associe chaque axe à un libellé descriptif et ajuste la mise en page avant d’afficher la figure. Ainsi, axes reste un tableau à deux dimensions pour une grille 2×2, une seule ligne (1×N), une seule colonne (N×1) ou un seul sous-graphique (1×1). Pour obtenir une grille d’une autre taille, adaptez les arguments de plt.subplots() et fournissez un titre pour chaque axe.

import numpy as np
import matplotlib.pyplot as plt

x = np.linspace(0, 2 * np.pi, 100)
series = [np.sin(x), np.cos(x), np.sin(2 * x), np.cos(2 * x)]
titles = ["Sine", "Cosine", "Sine, double frequency", "Cosine, double frequency"]

fig, axes = plt.subplots(2, 2, figsize=(8, 5), squeeze=False)
for ax, y, title in zip(axes.flat, series, titles):
    ax.plot(x, y)
    ax.set_title(title)

fig.tight_layout()
plt.show()

Une grille 2×2 de sous-graphiques titrés avec Axes.set_title() : Sine, Cosine, Sine double frequency et Cosine double frequency, chaque titre centré au-dessus de sa courbe.

Comme squeeze=False conserve les axes dans un tableau à deux dimensions, même pour une grille 1×1, axes.flat permet de parcourir de façon cohérente les quatre formes de grille : 2×2, 1×N, N×1 et 1×1. zip() associe chaque axe et chaque série de données à un titre ; veillez donc à conserver le même ordre et la même longueur pour ces collections.

L’argument label correspond au texte affiché au-dessus d’un axe. Vous pouvez aussi transmettre des options comme fontsize ou loc pour régler l’apparence et la position du titre. Gardez les titres longs concis ; si les titres ou les libellés voisins manquent d’espace, augmentez la taille de la figure ou ajustez l’espacement avant l’affichage. tight_layout() constitue un bon point de départ, mais une mise en page comportant de nombreux éléments décoratifs peut nécessiter des réglages supplémentaires.

Définir le titre d’un sous-graphique avec Axes.title.set_text()

Un objet Axes expose également son titre sous la forme d’un objet texte. Utilisez Axes.title.set_text() pour définir ou modifier ce texte une fois l’axe créé. Cette méthode peut être pratique si le programme conserve déjà une référence vers l’objet titre ou si le texte doit changer ultérieurement. Pour configurer un graphique dès sa création, Axes.set_title() est généralement plus direct et rend l’opération explicite à l’endroit où l’axe est appelé.

import numpy as np
import matplotlib.pyplot as plt

x = np.linspace(0, 2 * np.pi, 100)

fig, axes = plt.subplots(1, 2, figsize=(8, 3.5), squeeze=False)
axes[0, 0].plot(x, np.sin(x))
axes[0, 1].plot(x, np.cos(x))

axes[0, 0].title.set_text("Sine")
axes[0, 1].title.set_text("Cosine")

fig.tight_layout()
plt.show()

Deux sous-graphiques côte à côte dont les titres ont été définis avec Axes.title.set_text() : Sine au-dessus de la courbe sinus et Cosine au-dessus de la courbe cosinus.

Par exemple, après avoir créé un axe nommé ax, appelez ax.title.set_text("Updated title"). Cela met à jour le titre de cet axe ; la méthode ne définit pas le titre de tous les sous-graphiques de la figure. Si vous avez plusieurs axes, sélectionnez explicitement celui à modifier ou parcourez les axes et les chaînes de texte correspondantes, comme dans le premier exemple. Les deux API agissent sur le titre d’un axe ; choisissez donc une méthode pour une opération donnée au lieu de définir deux fois le même titre.

Définir le titre d’un sous-graphique avec les axes courants de pyplot

Avec l’interface de pyplot fondée sur un état courant, plt.gca() renvoie l’axe actif. Vous pouvez définir son titre avec plt.gca().set_title("Title") ; la forme équivalente utilisant l’objet texte est plt.gca().title.set_text("Title"). Les parenthèses sont importantes : gca() est un appel de fonction qui récupère l’axe courant. Ces formes n’agissent que sur l’axe actif à cet instant ; elles sont donc utiles lorsqu’on trace un axe à la fois.

import numpy as np
import matplotlib.pyplot as plt

x = np.linspace(0, 2 * np.pi, 100)
series = [np.sin(x), np.cos(x), np.sin(2 * x), np.cos(2 * x)]
titles = ["Sine", "Cosine", "Sine, double frequency", "Cosine, double frequency"]

plt.figure(figsize=(8, 5))
for position, (y, title) in enumerate(zip(series, titles), start=1):
    plt.subplot(2, 2, position)
    plt.plot(x, y)
    plt.gca().set_title(title)

plt.tight_layout()
plt.show()

La même grille 2×2 de courbes sinus et cosinus, construite en boucle avec plt.subplot() et plt.gca().set_title(), avec un titre au-dessus de chaque sous-graphique.

Pour une grille, sélectionnez chaque sous-graphique avant d’en définir le titre. Par exemple, plt.subplot(2, 2, position) sélectionne une position de un à quatre, puis plt.gca().set_title(title) applique le titre à l’axe sélectionné. Si vous créez la grille avec fig, axes = plt.subplots(...), il est généralement plus facile à suivre d’utiliser les références aux axes renvoyées, car le code dépend moins de l’état courant de pyplot.

Terminez la configuration de la figure avant d’appeler plt.show(). En particulier, appelez plt.tight_layout() avant l’affichage afin que la mise en page puisse tenir compte des titres des sous-graphiques.

Corriger les titres qui se chevauchent, sont rognés ou manquent

Un titre est centré au-dessus de son axe ; un titre long peut donc être plus large que l’axe lui-même. Avec les deux titres de l’exemple ci-dessous, sur une figure de taille (8, 3.5), les boîtes de titre mesurées se chevauchent de 15 pixels lorsqu’aucun ajustement de mise en page n’est appliqué : la fin d’un titre empiète sur le début du suivant. Appeler fig.tight_layout() les sépare — la même mesure laisse alors un écart de 39 pixels —, mais tight_layout() ne fait que redistribuer l’espace entre les sous-graphiques ; il ne réduit pas le texte du titre. À cette taille de figure, le second titre dépasse alors de 11 pixels le bord droit de la figure et se trouve rogné dans le rendu. La correction complète consiste à donner de la place aux titres : gardez tight_layout() et élargissez la figure, comme dans cet exemple, ou raccourcissez les titres. Réduire la fontsize du titre à 11 à la taille d’origine place également les deux titres entièrement dans la figure.

import numpy as np
import matplotlib.pyplot as plt

x = np.linspace(0, 2 * np.pi, 100)

fig, axes = plt.subplots(1, 2, figsize=(9, 3.5), squeeze=False)
axes[0, 0].plot(x, np.sin(x))
axes[0, 1].plot(x, np.cos(x))
axes[0, 0].set_title("Sine wave measured at the first sensor")
axes[0, 1].set_title("Cosine wave measured at the second sensor")

fig.tight_layout()
plt.show()

Deux sous-graphiques portant les titres longs Sine wave measured at the first sensor et Cosine wave measured at the second sensor, entièrement visibles et séparés après élargissement de la figure et application de tight_layout().

À la taille (9, 3.5), les deux titres se terminent à l’intérieur de la figure, avec un espace entre eux, et aucun texte n’est coupé. Un titre manquant, en revanche, échoue silencieusement : les boucles de cet article associent axes et titres via zip(), et zip() s’arrête à la séquence la plus courte sans lever d’erreur. Fournir trois titres pour les quatre sous-graphiques d’une grille 2×2 laisse le quatrième axe avec un titre vide — le relire avec ax.get_title() renvoie une chaîne vide — et rien ne vous avertit. Lorsqu’un sous-graphique apparaît sans titre, comptez les titres face aux axes avant de vérifier les appels de titre eux-mêmes.