matplotlib.figure.Figure.subplots#

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

Fügt dieser Abbildung einen Satz von Subplots hinzu.

Dieser Utility-Wrapper macht es bequem, gängige Layouts von Subplots mit 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 die gemeinsame Nutzung der x-Achse (sharex) oder y-Achse (sharey).

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 entfernt.
- 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. Äquivalent zu gridspec_kw={'height_ratios': [...]}.

subplot_kwdict, optional

Dict mit Schlüsselwörtern, die an den Figure.add_subplot-Aufruf übergeben werden, der zum Erstellen 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.

Gibt zurück:

Axes oder Array von Axes: Entweder ein einzelnes Axes-Objekt 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.

Siehe auch

pyplot.subplots
Figure.add_subplot
pyplot.subplot

Beispiele

# First create some toy data:
x = np.linspace(0, 2*np.pi, 400)
y = np.sin(x**2)

# Create a figure
fig = plt.figure()

# Create a subplot
ax = fig.subplots()
ax.plot(x, y)
ax.set_title('Simple plot')

# Create two subplots and unpack the output array immediately
ax1, ax2 = fig.subplots(1, 2, sharey=True)
ax1.plot(x, y)
ax1.set_title('Sharing Y axis')
ax2.scatter(x, y)

# Create four polar Axes and access them through the returned array
axes = fig.subplots(2, 2, subplot_kw=dict(projection='polar'))
axes[0, 0].plot(x, y)
axes[1, 1].scatter(x, y)

# Share an X-axis with each column of subplots
fig.subplots(2, 2, sharex='col')

# Share a Y-axis with each row of subplots
fig.subplots(2, 2, sharey='row')

# Share both X- and Y-axes with all subplots
fig.subplots(2, 2, sharex='all', sharey='all')

# Note that this is the same as
fig.subplots(2, 2, sharex=True, sharey=True)