mpl_toolkits.axisartist.axis_artist.AxisLabel

class mpl_toolkits.axisartist.axis_artist.AxisLabel(*args, axis_direction='bottom', axis=None, **kwargs)

Bases: AttributeCopier, LabelBase

Achsenbeschriftung. Abgeleitet von Text. Die Position des Textes wird laufend aktualisiert, sodass Änderungen der Textposition keine Auswirkungen haben. Ansonsten können die Eigenschaften wie bei einem normalen Text geändert werden.

Um den Abstand zwischen den Tick-Beschriftungen und der Achsenbeschriftung zu ändern, verwenden Sie set_pad.

draw(renderer)

Zeichnet den Künstler (und seine Kinder) mit dem gegebenen Renderer.

Dies hat keine Auswirkung, wenn der Künstler nicht sichtbar ist (Artist.get_visible gibt False zurück).

Parameter:

rendererRendererBase Unterklasse.

Anmerkungen

Diese Methode wird in den Künstler-Unterklassen überschrieben.

get_color()

Gibt die Textfarbe zurück.

get_pad()

Gibt den internen Abstand in Punkten zurück.

Siehe set_pad für weitere Details.

get_ref_artist()

Gibt den zugrunde liegenden Künstler zurück, der einige Eigenschaften (z. B. Farbe) dieses Künstlers tatsächlich definiert.

get_text()

Gibt die Textzeichenkette zurück.

get_window_extent(renderer=None)

Gibt die Bbox zurück, die den Text umschließt, in Anzeigeeinheiten.

Zusätzlich zur internen Verwendung ist dies nützlich, um klickbare Bereiche in einer PNG-Datei auf einer Webseite anzugeben.

Parameter:

rendererRenderer, optional

Ein Renderer wird benötigt, um die Bounding Box zu berechnen. Wenn der Künstler bereits gezeichnet wurde, wird der Renderer zwischengespeichert. Daher muss dieses Argument nur übergeben werden, wenn get_window_extent vor dem ersten Zeichnen aufgerufen wird. In der Praxis ist es meist einfacher, zuerst ein Zeichnen auszulösen, z. B. durch Aufrufen von draw_without_rendering oder plt.show().

dpifloat, optional

Der DPI-Wert für die Berechnung der Bbox, standardmäßig self.get_figure(root=True).dpi (nicht die Renderer-DPI); sollte z. B. gesetzt werden, um Bereiche mit einer Abbildung abzugleichen, die mit einer benutzerdefinierten DPI gespeichert wurde.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, axis_direction=<UNSET>, backgroundcolor=<UNSET>, bbox=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, default_alignment=<UNSET>, default_angle=<UNSET>, fontfamily=<UNSET>, fontproperties=<UNSET>, fontsize=<UNSET>, fontstretch=<UNSET>, fontstyle=<UNSET>, fontvariant=<UNSET>, fontweight=<UNSET>, gid=<UNSET>, horizontalalignment=<UNSET>, in_layout=<UNSET>, label=<UNSET>, linespacing=<UNSET>, math_fontfamily=<UNSET>, mouseover=<UNSET>, multialignment=<UNSET>, pad=<UNSET>, parse_math=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, position=<UNSET>, rasterized=<UNSET>, rotation=<UNSET>, rotation_mode=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, text=<UNSET>, transform=<UNSET>, transform_rotates_text=<UNSET>, url=<UNSET>, usetex=<UNSET>, verticalalignment=<UNSET>, visible=<UNSET>, wrap=<UNSET>, x=<UNSET>, y=<UNSET>, zorder=<UNSET>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

Eigenschaft	Beschreibung
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
animated	bool
antialiased	bool
axis_direction	{"left", "bottom", "right", "top"}
backgroundcolor	color
bbox	dict mit Eigenschaften für patches.FancyBboxPatch
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
color oder c	color
default_alignment	{"left", "bottom", "right", "top"}
default_angle	{"left", "bottom", "right", "top"}
figure	Figure oder SubFigure
fontfamily oder family oder fontname	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties oder font oder font_properties	font_manager.FontProperties oder str oder pathlib.Path
fontsize oder size	float oder {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch oder stretch	{ein numerischer Wert im Bereich 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
fontstyle oder style	{'normal', 'italic', 'oblique'}
fontvariant oder variant	{'normal', 'small-caps'}
fontweight oder weight	{ein numerischer Wert im Bereich 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
gid	str
horizontalalignment oder ha	{'left', 'center', 'right'}
in_layout	bool
label	object
linespacing	float (Vielfaches der Schriftgröße)
math_fontfamily	str
mouseover	bool
multialignment oder ma	{'left', 'right', 'center'}
pad	float
parse_math	bool
path_effects	Liste von AbstractPathEffect
picker	None oder bool oder float oder callable
position	(float, float)
rasterized	bool
rotation	float oder {'vertical', 'horizontal'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
text	object
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool, Standard: rcParams["text.usetex"] (Standard: False)
verticalalignment oder va	{'baseline', 'bottom', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	float
y	float
zorder	float

set_axis_direction(d)

Passt den Textwinkel und die Textausrichtung der Achsenbeschriftung gemäß der Matplotlib-Konvention an.

Eigenschaft	links	unten	rechts	oben
Achsenbeschriftungs-Winkel	180	0	0	180
Achsenbeschriftungs va	Mitte	oben	Mitte	unten
Achsenbeschriftungs ha	rechts	Mitte	rechts	Mitte

Beachten Sie, dass die Textwinkel tatsächlich relativ zu (90 + Winkel der Richtung zum Ticklabel) sind, was 0 für die untere Achse ergibt.

Parameter:

d{"left", "bottom", "right", "top"}

set_default_alignment(d)

Setzt die Standardausrichtung. Siehe set_axis_direction für Details.

Parameter:

d{"left", "bottom", "right", "top"}

set_default_angle(d)

Setzt den Standardwinkel. Siehe set_axis_direction für Details.

Parameter:

d{"left", "bottom", "right", "top"}

set_pad(pad)

Setzt den internen Abstand in Punkten.

Der tatsächliche Abstand ist die Summe aus dem internen Abstand und dem externen Abstand (letzterer wird automatisch vom AxisArtist gesetzt).

Parameter:

padfloat

Der interne Abstand in Punkten.