matplotlib.figure.SubFigure.add_subplot

SubFigure.add_subplot(*args, **kwargs)

Fügt ein Axes zur Figur als Teil einer Subplot-Anordnung hinzu.

Aufrufsignaturen

add_subplot(nrows, ncols, index, **kwargs)
add_subplot(pos, **kwargs)
add_subplot(ax)
add_subplot()

Parameter:

*argsint, (int, int, index) oder SubplotSpec, Standard: (1, 1, 1)

Die Position des Subplots, beschrieben durch eines der folgenden:

• Drei Ganzzahlen (*nrows*, *ncols*, *index*). Der Subplot nimmt die index-Position in einem Raster mit nrows Zeilen und ncols Spalten ein. index beginnt in der oberen linken Ecke mit 1 und erhöht sich nach rechts. index kann auch ein Tupel aus zwei Zahlen sein, das die (erste, letzte) Indizes (1-basiert und einschließlich letzter) des Subplots angibt, z. B. fig.add_subplot(3, 1, (1, 2)) erstellt einen Subplot, der sich über die oberen 2/3 der Abbildung erstreckt.

• Eine 3-stellige Ganzzahl. Die Ziffern werden so interpretiert, als wären sie separat als drei einstellige Ganzzahlen angegeben, d. h. fig.add_subplot(235) ist dasselbe wie fig.add_subplot(2, 3, 5). Beachten Sie, dass dies nur verwendet werden kann, wenn nicht mehr als 9 Subplots vorhanden sind.

• Ein SubplotSpec.

In seltenen Fällen kann add_subplot mit einem einzigen Argument aufgerufen werden, einer bereits erstellten Subplot-Axes-Instanz in der aktuellen Figur, die jedoch nicht in der Liste der Axes der Figur enthalten ist.

projection{None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optional

Der Projektionstyp des Subplots (Axes). str ist der Name einer benutzerdefinierten Projektion, siehe projections. Der Standardwert None ergibt eine 'rectiligneare' Projektion.

polarbool, default: False

Wenn True, ist dies äquivalent zu projection='polar'.

axes_classUnterklasse vom Typ Axes, optional

Die instanziierte axes.Axes-Unterklasse. Dieser Parameter ist inkompatibel mit projection und polar. Siehe axisartist für Beispiele.

sharex, shareyAxes, optional

Teilt die x- oder y-achse mit sharex und/oder sharey. Die Achse hat die gleichen Grenzen, Ticks und Skalen wie die Achse der geteilten Axes.

labelstr

Ein Label für die zurückgegebene Achse.

Gibt zurück:

Axes

Die Axes des Subplots. Die zurückgegebene Axes kann tatsächlich eine Instanz einer Unterklasse sein, wie z.B. projections.polar.PolarAxes für polare Projektionen.

Andere Parameter:

**kwargs

Diese Methode nimmt auch die Schlüsselwortargumente für die zurückgegebene Basisklasse der Axes entgegen; mit Ausnahme des Arguments figure. Die Schlüsselwortargumente für die rectiligneare Basisklasse Axes finden Sie in der folgenden Tabelle, aber es können auch andere Schlüsselwortargumente vorhanden sein, wenn eine andere Projektion verwendet wird.

Eigenschaft	Beschreibung
adjustable	{'box', 'datalim'}
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
alpha	float oder None
anchor	(float, float) oder {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	bool
aspect	{'auto', 'equal'} oder float
autoscale_on	bool
autoscalex_on	unknown
autoscaley_on	unknown
axes_locator	Callable[[Axes, Renderer], Bbox]
axisbelow	bool oder 'line'
box_aspect	float oder None
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
facecolor oder fc	color
figure	Figure oder SubFigure
forward_navigation_events	bool oder "auto"
frame_on	bool
gid	str
in_layout	bool
label	object
mouseover	bool
navigate	bool
navigate_mode	unknown
path_effects	Liste von AbstractPathEffect
picker	None oder bool oder float oder callable
position	[left, bottom, width, height] oder Bbox
prop_cycle	Cycler
rasterization_zorder	float oder None
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
subplotspec	unknown
title	str
transform	Transform
url	str
visible	bool
xbound	(lower: float, upper: float)
xlabel	str
xlim	(left: float, right: float)
xmargin	float größer als -0.5
xscale	unknown
xticklabels	unknown
xticks	unknown
ybound	(lower: float, upper: float)
ylabel	str
ylim	(bottom: float, top: float)
ymargin	float größer als -0.5
yscale	unknown
yticklabels	unknown
yticks	unknown
zorder	float

Siehe auch

Figure.add_axes

pyplot.subplot

pyplot.axes

Figure.subplots

pyplot.subplots

Beispiele

fig = plt.figure()

fig.add_subplot(231)
ax1 = fig.add_subplot(2, 3, 1)  # equivalent but more general

fig.add_subplot(232, frameon=False)  # subplot with no frame
fig.add_subplot(233, projection='polar')  # polar subplot
fig.add_subplot(234, sharex=ax1)  # subplot sharing x-axis with ax1
fig.add_subplot(235, facecolor="red")  # red subplot

ax1.remove()  # delete ax1 from the figure
fig.add_subplot(ax1)  # add ax1 back to the figure