matplotlib.figure.SubFigure.subplots#
- SubFigure.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_unitsjede 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. Entsprichtgridspec_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 zugridspec_kw={'height_ratios': [...]}.- subplot_kwdict, optional
Dict mit Schlüsselwörtern, die an den Aufruf von
Figure.add_subplotübergeben werden, der zur Erstellung jedes Unterplots 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:
Siehe auch
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)
