matplotlib.pyplot.subplots#

matplotlib.pyplot.subplots(nrows=1, ncols=1, *, sharex=False, sharey=False, squeeze=True, width_ratios=None, height_ratios=None, subplot_kw=None, gridspec_kw=None, **fig_kw)[Quelle]#

Erstellt eine Figure und eine Menge von Subplots.

Dieser Utility-Wrapper macht es bequem, gängige Layouts von Subplots, einschließlich des umgebenden Figure-Objekts, in einem einzigen Aufruf zu erstellen.

Parameter:

nrows, ncolsint, Standard: 1

Anzahl der Zeilen/Spalten des Subplot-Gitters.

sharex, shareybool oder {'none', 'all', 'row', 'col'}, Standard: False

Steuert das Teilen von Eigenschaften zwischen X- (sharex) oder Y- (sharey) Achsen.

True oder 'all': Die X- oder Y-Achse wird zwischen allen Subplots geteilt.
False oder 'none': Jede Subplot-X- oder Y-Achse ist unabhängig.
'row': Jede Subplot-Zeile teilt eine X- oder Y-Achse.
'col': Jede Subplot-Spalte teilt eine X- oder Y-Achse.

Wenn Subplots eine gemeinsame X-Achse entlang einer Spalte haben, werden nur die X-Tick-Beschriftungen des untersten Subplots erstellt. Ähnlich, wenn Subplots eine gemeinsame Y-Achse entlang einer Zeile haben, werden nur die Y-Tick-Beschriftungen des ersten Spalten-Subplots erstellt. Um die Tick-Beschriftungen anderer Subplots später einzuschalten, verwenden Sie tick_params.

Wenn Subplots eine gemeinsame Achse mit Einheiten haben, wird das Aufrufen von Axis.set_units jede Achse mit den neuen Einheiten aktualisieren.

Beachten Sie, dass es nicht möglich ist, Achsen zu entkoppeln.

squeezebool, Standard: True

Wenn True, werden zusätzliche Dimensionen aus dem zurückgegebenen Array von Axes herausgequetscht.
- Wenn nur ein Subplot erstellt wird (nrows=ncols=1), wird das resultierende einzelne Axes-Objekt als Skalar zurückgegeben.
- Für Nx1- oder 1xM-Subplots ist das zurückgegebene Objekt ein 1D-NumPy-Objekt-Array von Axes-Objekten.
- Für NxM-Subplots mit N>1 und M>1 wird ein 2D-Array zurückgegeben.
Wenn False, wird überhaupt kein Quetschen durchgeführt: Das zurückgegebene Axes-Objekt ist immer ein 2D-Array, das Axes-Instanzen enthält, auch wenn es sich um ein 1x1-Array handelt.

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': [...]}.

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': [...]}.

subplot_kwdict, optional

Dict mit Schlüsselwörtern, die an den add_subplot Aufruf übergeben werden, der zur Erstellung jedes Subplots verwendet wird.

gridspec_kwdict, optional

Dict mit Schlüsselwörtern, die an den Konstruktor von GridSpec übergeben werden, der zur Erstellung des Gitters verwendet wird, auf dem die Subplots platziert werden.

**fig_kw

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

Gibt zurück:

figFigure

axAxes oder Array von Axes

ax kann entweder ein einzelnes Axes-Objekt sein, oder ein Array von Axes-Objekten, wenn mehr als ein Subplot erstellt wurde. Die Dimensionen des resultierenden Arrays können mit dem Schlüsselwort squeeze gesteuert werden, siehe oben.

Typische Idiome für die Handhabung des Rückgabewerts sind

# using the variable ax for single a Axes
fig, ax = plt.subplots()

# using the variable axs for multiple Axes
fig, axs = plt.subplots(2, 2)

# using tuple unpacking for multiple Axes
fig, (ax1, ax2) = plt.subplots(1, 2)
fig, ((ax1, ax2), (ax3, ax4)) = plt.subplots(2, 2)

Die Namen ax und die pluralisierte Form axs werden gegenüber axes bevorzugt, da bei letzterem unklar ist, ob es sich um eine einzelne Axes-Instanz oder eine Sammlung davon handelt.

matplotlib.pyplot.subplots#

Beispiele für die Verwendung von matplotlib.pyplot.subplots#

Beispiele für die Verwendung von `matplotlib.pyplot.subplots`#