mpl_toolkits.axisartist.axis_artist.LabelBase

class mpl_toolkits.axisartist.axis_artist.LabelBase(*args, **kwargs)

Bases: Text

Eine Basisklasse für AxisLabel und TickLabels. Die Position und der Winkel des Textes werden durch die Attribute offset_ref_angle, text_ref_angle und offset_radius berechnet.

Erstellt eine Text-Instanz an den Positionen x, y mit dem String text.

Der Text wird relativ zum Ankerpunkt (x, y) gemäß horizontalalignment (Standard: 'left') und verticalalignment (Standard: 'baseline') ausgerichtet. Siehe auch Textausrichtung.

Obwohl Text das Schlüsselwortargument 'label' akzeptiert, wird es standardmäßig nicht zu den Handles einer Legende hinzugefügt.

Gültige Schlüsselwortargumente 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
backgroundcolor	color
bbox	dict mit Eigenschaften für patches.FancyBboxPatch
clip_box	unknown
clip_on	unknown
clip_path	unknown
color oder c	color
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'}
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

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_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 ist es nur notwendig, dieses Argument zu übergeben, wenn get_window_extent vor dem ersten Zeichnen aufgerufen wird. In der Praxis ist es normalerweise 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>, backgroundcolor=<UNSET>, bbox=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<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>, 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
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
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'}
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