HOWTO · Matplotlib
Wie man Subplots in Matplotlib einen Titel hinzufügt
Wir können Subplots in Matplotlib einen Titel hinzufügen, indem wir Axes.set_title(), Axes.title.set_text() oder die aktuelle Achse von pyplot (plt.gca()) verwenden.
Auf dieser Seite
Um jeder Teilgrafik einen eigenen Titel zu geben, rufen Sie Axes.set_title() für die entsprechende Achse auf. Das ist die klarste Wahl, wenn Sie mehrere Diagramme gemeinsam erstellen, denn jeder Titel bleibt der Achse zugeordnet, die er beschreibt. Der Titel einer Teilgrafik gehört zu einer einzelnen Achse; verwenden Sie einen Titel für die gesamte Abbildung, etwa mit fig.suptitle(), wenn eine Überschrift die ganze Abbildung beschreiben soll.
Titel für Teilgrafiken mit Axes.set_title() hinzufügen
plt.subplots() gibt eine Abbildung und ein Array von Achsen zurück, wenn squeeze=False gesetzt ist. Das folgende Beispiel zeichnet vier Datenreihen, ordnet jeder Achse eine aussagekräftige Beschriftung zu und passt das Layout an, bevor die Abbildung angezeigt wird. Dadurch bleibt axes bei einem 2×2-Raster, einer einzelnen Zeile (1×N), einer einzelnen Spalte (N×1) oder einer einzelnen Teilgrafik (1×1) zweidimensional. Für eine andere Rastergröße passen Sie die Argumente von plt.subplots() an und geben Sie für jede Achse einen Titel an.
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()
Da squeeze=False das Array der Achsen selbst bei einem 1×1-Raster zweidimensional hält, durchläuft axes.flat alle vier Rasterformen einheitlich: 2×2, 1×N, N×1 und 1×1. zip() ordnet jeder Achse und Datenreihe einen Titel zu. Achten Sie daher darauf, dass die Sammlungen dieselbe Reihenfolge und Länge haben.
Das Argument label enthält den Text, der über einer Achse angezeigt wird. Sie können auch Optionen wie fontsize oder loc übergeben, um Aussehen und Position des Titels festzulegen. Halten Sie lange Titel knapp. Wenn benachbarte Titel oder Beschriftungen wenig Platz haben, vergrößern Sie die Abbildung oder passen Sie vor der Anzeige die Abstände an. tight_layout() ist ein guter Ausgangspunkt; bei vielen zusätzlichen Elementen können jedoch weitere Abstandsänderungen nötig sein.
Titel für Teilgrafiken mit Axes.title.set_text() festlegen
Eine Achse stellt ihren Titel auch als Textobjekt bereit. Mit Axes.title.set_text() können Sie diesen Text festlegen oder ändern, sobald die Achse erstellt wurde. Das ist praktisch, wenn ein Programm bereits eine Referenz auf das Titelobjekt speichert oder den Wortlaut später ändert. Beim erstmaligen Einrichten eines Diagramms ist Axes.set_title() in der Regel direkter und macht den Vorgang an der Stelle des Achsenaufrufs klar.
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()
Rufen Sie beispielsweise nach dem Erstellen einer Achse namens ax ax.title.set_text("Updated title") auf. Damit wird der Titel dieser Achse aktualisiert; die Titel der übrigen Teilgrafiken werden dadurch nicht gesetzt. Bei mehreren Achsen wählen Sie die zu ändernde Achse ausdrücklich aus oder durchlaufen Sie die Achsen und die zugehörigen Zeichenketten wie im ersten Beispiel. Beide APIs bearbeiten den Achsentitel. Verwenden Sie daher für einen Vorgang einen Stil, statt denselben Titel zweimal zu setzen.
Titel für Teilgrafiken mit der aktuellen Achse von pyplot festlegen
Bei der zustandsbasierten Schnittstelle von pyplot gibt plt.gca() die aktuelle Achse zurück. Deren Titel lässt sich mit plt.gca().set_title("Title") festlegen; die entsprechende Variante mit dem Textobjekt lautet plt.gca().title.set_text("Title"). Die Klammern sind wichtig: gca() ist ein Funktionsaufruf, der die aktuelle Achse abruft. Diese Formen wirken nur auf die gerade aktuelle Achse und eignen sich daher, wenn Sie jeweils eine einzelne Achse bearbeiten.
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()
Bei einem Raster wählen Sie jede Teilgrafik aus, bevor Sie ihren Titel festlegen. So wählt beispielsweise plt.subplot(2, 2, position) eine Position von eins bis vier aus; anschließend setzt plt.gca().set_title(title) den Titel für die ausgewählte Achse. Wenn Sie das Raster mit fig, axes = plt.subplots(...) erstellen, sind die zurückgegebenen Achsenreferenzen in der Regel leichter nachzuvollziehen und weniger vom aktuellen Zustand von pyplot abhängig.
Schließen Sie die Konfiguration der Abbildung ab, bevor Sie plt.show() aufrufen. Rufen Sie insbesondere plt.tight_layout() vor der Anzeige auf, damit das Layout die Titel der Teilgrafiken berücksichtigen kann.
Überlappende oder abgeschnittene Titel und fehlende Titel beheben
Ein Titel wird über seiner Achse zentriert, daher kann ein langer Titel breiter sein als die Achse selbst. Bei den beiden Titeln im folgenden Beispiel überlappen sich die gemessenen Titelboxen auf einer Abbildung der Größe (8, 3.5) um 15 Pixel, wenn keine Layoutanpassung vorgenommen wird – das Ende des einen Titels läuft in den Anfang des nächsten. fig.tight_layout() trennt die beiden – dieselbe Messung ergibt dann einen Abstand von 39 Pixeln –, aber tight_layout() verteilt nur den Raum zwischen den Teilgrafiken neu; der Titeltext wird nicht verkleinert. Bei dieser Abbildungsgröße ragt der zweite Titel dann 11 Pixel über den rechten Rand der Abbildung hinaus und wird in der gerenderten Ausgabe abgeschnitten. Die vollständige Lösung besteht darin, den Titeln Platz zu geben: Behalten Sie tight_layout() bei und verbreitern Sie die Abbildung wie in diesem Beispiel, oder kürzen Sie die Titel. Auch eine Verringerung der fontsize des Titels auf 11 bei der ursprünglichen Größe bringt beide Titel vollständig in die Abbildung.
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()
Bei der Größe (9, 3.5) enden beide Titel innerhalb der Abbildung, mit Abstand zueinander, und kein Text wird abgeschnitten. Ein fehlender Titel fällt dagegen still aus: Die Schleifen in diesem Artikel ordnen Achsen und Titel über zip() zu, und zip() stoppt an der kürzeren Sequenz, ohne einen Fehler auszulösen. Werden für die vier Teilgrafiken eines 2×2-Rasters nur drei Titel angegeben, bleibt die vierte Achse mit einem leeren Titel zurück – ein Auslesen mit ax.get_title() liefert eine leere Zeichenkette –, und nichts warnt Sie. Wenn eine Teilgrafik ohne Titel erscheint, zählen Sie zuerst die Titel gegen die Achsen, bevor Sie die Titelaufrufe selbst prüfen.