matplotlib.axes.Axes

class matplotlib.axes.Axes(fig, *args, facecolor=None, frameon=True, sharex=None, sharey=None, label='', xscale=None, yscale=None, box_aspect=None, forward_navigation_events='auto', **kwargs)

Ein Axes-Objekt kapselt alle Elemente eines einzelnen (Unter-)Plots in einer Figur.

Es enthält die meisten (Unter-)Plot-Elemente: Axis, Tick, Line2D, Text, Polygon usw. und legt das Koordinatensystem fest.

Wie alle sichtbaren Elemente in einer Figur ist Axes eine Unterklasse von Artist.

Die Axes-Instanz unterstützt Rückruffunktionen über ein Callback-Attribut, das eine CallbackRegistry-Instanz ist. Die Ereignisse, an die Sie sich anschließen können, sind 'xlim_changed' und 'ylim_changed', und die Rückruffunktion wird mit func(ax) aufgerufen, wobei ax die Axes-Instanz ist.

Hinweis

Als Benutzer instanziieren Sie Axes nicht direkt, sondern verwenden stattdessen Axes-Erstellungsmethoden; z.B. aus pyplot oder Figure: subplots, subplot_mosaic oder Figure.add_axes.

Erstellt eine Axes in einer Figur.

Parameter:

figFigure

Die Axes wird in der Figure fig erstellt.

*args

*args kann ein einzelnes (left, bottom, width, height) Rechteck oder ein einzelnes Bbox sein. Dies gibt das Rechteck (in Figure-Koordinaten) an, in dem die Axes positioniert wird.

*args kann auch aus drei Zahlen oder einer einzigen dreistelligen Zahl bestehen; im letzteren Fall werden die Ziffern als unabhängige Zahlen betrachtet. Die Zahlen werden als (nrows, ncols, index) interpretiert: (nrows, ncols) gibt die Größe eines Arrays von Subplots an, und index ist der 1-basierte Index des erstellten Subplots. Schließlich kann *args auch direkt eine SubplotSpec-Instanz sein.

sharex, shareyAxes, optional

Die x- bzw. y-axis wird mit der x- bzw. y-Achse im Eingabe-Axes geteilt. Beachten Sie, dass es nicht möglich ist, Achsen zu entkoppeln.

frameonbool, Standard: True

Ob der Rahmen der Axes sichtbar ist.

box_aspectfloat, optional

Setzt ein festes Seitenverhältnis für die Axes-Box, d.h. das Verhältnis von Höhe zu Breite. Details siehe set_box_aspect.

forward_navigation_eventsbool oder "auto", Standard: "auto"

Steuert, ob Pan/Zoom-Ereignisse an die darunter liegenden Axes weitergegeben werden. "auto" ist True für Axes mit einem unsichtbaren Patch und False andernfalls.

**kwargs

Andere optionale Schlüsselwortargumente

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

Gibt zurück:

Axes

Das neue Axes-Objekt.