matplotlib.gridspec.GridSpec#

class matplotlib.gridspec.GridSpec(nrows, ncols, figure=None, left=None, bottom=None, right=None, top=None, wspace=None, hspace=None, width_ratios=None, height_ratios=None)[Quelle]#

Bases: GridSpecBase

Ein Gitterlayout zur Platzierung von Subplots innerhalb einer Figur.

Die Position der Gitterzellen wird ähnlich wie bei SubplotParams mithilfe von left, right, top, bottom, wspace und hspace bestimmt.

Das Indizieren einer GridSpec-Instanz gibt ein SubplotSpec zurück.

Parameter:

nrows, ncolsint: Die Anzahl der Zeilen und Spalten des Gitters.
figureFigure, optional: Wird nur für das "constrained layout" verwendet, um ein korrektes Layoutgitter zu erstellen.
left, right, top, bottomfloat, optional: Grenzen der Subplots als Bruchteil der Figurenbreite oder -höhe. Links darf nicht größer als rechts sein, und unten darf nicht größer als oben sein. Wenn nicht angegeben, werden die Werte zur Zeichenzeit aus der Figur oder den rcParams abgeleitet. Siehe auch GridSpec.get_subplot_params.
wspacefloat, optional: Der Platz für den Abstand zwischen den Subplots, ausgedrückt als Bruchteil der durchschnittlichen Achsenbreite. Wenn nicht angegeben, werden die Werte bei Bedarf aus der Figur oder den rcParams abgeleitet. Siehe auch GridSpec.get_subplot_params.
hspacefloat, optional: Der Platz für den Abstand zwischen den Subplots, ausgedrückt als Bruchteil der durchschnittlichen Achsenhöhe. Wenn nicht angegeben, werden die Werte bei Bedarf aus der Figur oder den rcParams abgeleitet. Siehe auch GridSpec.get_subplot_params.
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.
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.

get_subplot_params(figure=None)[Quelle]#

Gibt die SubplotParams für die GridSpec zurück.

In der Reihenfolge der Priorität werden die Werte übernommen von

nicht-None-Attributen der GridSpec
der bereitgestellten figure
rcParams["figure.subplot.*"]

Beachten Sie, dass das Attribut figure der GridSpec immer ignoriert wird.

locally_modified_subplot_params()[Quelle]#

Gibt eine Liste der Namen der Subplot-Parameter zurück, die explizit in der GridSpec gesetzt wurden.

Dies ist eine Teilmenge der Attribute von SubplotParams.

tight_layout(figure, renderer=None, pad=1.08, h_pad=None, w_pad=None, rect=None)[Quelle]#

Passt die Subplot-Parameter an, um den angegebenen Abstand zu erzielen.

Parameter:

figureFigure: Die Figur.
rendererRendererBase Unterklasse, optional: Der zu verwendende Renderer.
padfloat: Abstand zwischen dem Figurenrand und den Rändern der Subplots, als Bruchteil der Schriftgröße.
h_pad, w_padfloat, optional: Abstand (Höhe/Breite) zwischen den Rändern benachbarter Subplots. Standardwert ist pad.
recttuple (links, unten, rechts, oben), Standard: None: (links, unten, rechts, oben) Rechteck in normalisierten Figure-Koordinaten, in das der gesamte Subplot-Bereich (einschließlich Beschriftungen) passen wird. Standard (None) ist die gesamte Figur.

update(**kwargs)[Quelle]#

Aktualisiert die Subplot-Parameter des Gitters.

Nicht explizit angegebene Parameter werden nicht geändert. Das Setzen eines Parameters auf None setzt ihn auf rcParams["figure.subplot.*"] zurück.

Parameter:

left, right, top, bottomfloat oder None, optional: Grenzen der Subplots als Bruchteil der Figurenbreite oder -höhe.
wspace, hspacefloat, optional: Abstand zwischen den Subplots als Bruchteil der durchschnittlichen Subplot-Breite / -höhe.