matplotlib.figure.Figure.subplot_mosaic#

Figure.subplot_mosaic(mosaic, *, sharex=False, sharey=False, width_ratios=None, height_ratios=None, empty_sentinel='.', subplot_kw=None, per_subplot_kw=None, gridspec_kw=None)[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 eine Zeichenkette ist, kann sie entweder eine mehrzeilige Zeichenkette der Form sein

'''
AAE
C.E
'''

wobei jedes Zeichen eine Spalte und jede Zeile eine Reihe ist. Oder es kann eine einzeilige Zeichenkette sein, bei der die Reihen durch ; getrennt sind.

'AB;CC'

Die Zeichenkettennotation erlaubt nur einzeichenige Achsenbeschriftungen und unterstützt keine Verschachtelung, ist aber sehr kurz.

Die Achsenidentifikatoren können str oder ein nicht iterierbares hashbares Objekt sein (z. B. tuple darf nicht verwendet werden).

sharex, shareybool, Standard: False

Wenn True, wird die x-Achse (sharex) oder y-Achse (sharey) für alle Teilplots geteilt. In diesem Fall verhalten sich die Sichtbarkeit von Achsenbeschriftungen und die Achseneinheiten wie bei subplots. Wenn False, ist die x- oder y-Achse jedes Teilplots 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. Entspricht gridspec_kw={'width_ratios': [...]}. Im Falle von verschachtelten Layouts gilt dieses Argument nur für das äußere Layout.

height_ratiosarray-ähnlich der Länge nrows, optional

Definiert die relativen Höhen der Reihen. Jede Reihe erhält eine relative Höhe von height_ratios[i] / sum(height_ratios). Wenn nicht angegeben, haben alle Reihen die gleiche Höhe. Entspricht gridspec_kw={'height_ratios': [...]}. Im Falle von verschachtelten Layouts gilt dieses Argument nur für das äußere Layout.

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 Teilplots platziert werden. Im Falle von verschachtelten Layouts gilt dieses Argument nur für das äußere Layout. Für komplexere Layouts sollten Benutzer Figure.subfigures verwenden, um die Verschachtelung zu erstellen.

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.

Gibt zurück:

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.