matplotlib.pyplot.subplot_mosaic#

matplotlib.pyplot.subplot_mosaic(mosaic, *, sharex=False, sharey=False, width_ratios=None, height_ratios=None, empty_sentinel='.', subplot_kw=None, gridspec_kw=None, per_subplot_kw=None, **fig_kw)[Quelle]#

Erstellt ein Layout von Achsen basierend auf ASCII-Art oder verschachtelten Listen.

Dies ist eine Hilfsfunktion zum visuellen Aufbau komplexer GridSpec-Layouts.

Siehe Komplexe und semantische Figurenzusammensetzung (subplot_mosaic) für ein Beispiel und die vollständige API-Dokumentation

Parameter:

mosaicListe von Listen von {hashable oder verschachtelt} oder str

Ein visuelles Layout, wie Sie Ihre Achsen beschriftet mit Zeichenketten anordnen möchten. Zum Beispiel

x = [['A panel', 'A panel', 'edge'],
     ['C panel', '.',       'edge']]

erzeugt 4 Achsen

'A panel', das 1 Zeile hoch ist und die ersten beiden Spalten überspannt
'edge', das 2 Zeilen hoch ist und sich am rechten Rand befindet
'C panel', das in der unteren linken Ecke 1 Zeile und 1 Spalte breit ist
ein leerer Platz 1 Zeile und 1 Spalte breit in der Mitte unten

Jeder der Einträge im Layout kann eine Liste von Listen der gleichen Form sein, um verschachtelte Layouts zu erstellen.

Wenn die Eingabe ein String ist, muss er die Form haben

'''
AAE
C.E
'''

wobei jedes Zeichen eine Spalte und jede Zeile eine Reihe darstellt. Dies erlaubt nur Achsenbeschriftungen mit einzelnen Zeichen und keine Verschachtelung, ist aber sehr kurz.

sharex, shareybool, Standard: False

Wenn True, wird die x-Achse (sharex) oder y-Achse (sharey) von allen Unterplots gemeinsam genutzt. In diesem Fall verhalten sich die Sichtbarkeit von Tick-Labels und die Achseneinheiten wie bei subplots. Wenn False, ist die x- oder y-Achse jedes Unterplots unabhängig.

width_ratiosarray-ähnlich der Länge ncols, optional

Definiert die relativen Breiten der Spalten. Jede Spalte erhält eine relative Breite von width_ratios[i] / sum(width_ratios). Wenn nicht angegeben, haben alle Spalten die gleiche Breite. Bequemlichkeit für gridspec_kw={'width_ratios': [...]}.

height_ratiosarray-ähnlich der Länge nrows, optional

Definiert die relativen Höhen der Zeilen. Jede Zeile erhält eine relative Höhe von height_ratios[i] / sum(height_ratios). Wenn nicht angegeben, haben alle Zeilen die gleiche Höhe. Bequemlichkeit für gridspec_kw={'height_ratios': [...]}.

empty_sentinelobject, optional

Eintrag im Layout, der bedeutet "diesen Platz leer lassen". Standard ist '.'. Beachten Sie, dass, wenn layout ein String ist, dieser über inspect.cleandoc verarbeitet wird, um führende Leerzeichen zu entfernen, was die Verwendung von Leerzeichen als leeren Sentinel beeinträchtigen kann.

subplot_kwdict, optional

Wörterbuch mit Schlüsselwörtern, die an den Figure.add_subplot-Aufruf übergeben werden, der zum Erstellen jedes Unterplots verwendet wird. Diese Werte können durch Werte in per_subplot_kw überschrieben werden.

per_subplot_kwdict, optional

Ein Wörterbuch, das die Achsen-Identifikatoren oder Tupel von Identifikatoren auf ein Wörterbuch mit Schlüsselwortargumenten abbildet, die an den Figure.add_subplot-Aufruf übergeben werden sollen, der zum Erstellen jedes Unterplots verwendet wird. Die Werte in diesen Wörterbüchern haben Vorrang vor den Werten in subplot_kw.

Wenn mosaic ein String ist und somit alle Schlüssel einzelne Zeichen sind, ist es möglich, einen einzelnen String anstelle eines Tupels als Schlüssel zu verwenden; d. h. "AB" ist äquivalent zu ("A", "B").

Hinzugefügt in Version 3.7.

gridspec_kwdict, optional

Wörterbuch mit Schlüsselwörtern, die an den GridSpec-Konstruktor übergeben werden, der zum Erstellen des Rasters verwendet wird, auf dem die Unterplots platziert werden.

**fig_kw

Alle zusätzlichen Schlüsselwortargumente werden an den pyplot.figure-Aufruf übergeben.

Gibt zurück:

figFigure: Die neue Abbildung
dict[label, Axes]: Ein Wörterbuch, das die Beschriftungen auf die Achsenobjekte abbildet. Die Reihenfolge der Achsen erfolgt von links nach rechts und von oben nach unten entsprechend ihrer Position im Gesamtlayout.