mpl_toolkits.axisartist.axis_artist.AxisLabel

classmpl_toolkits.axisartist.axis_artist.AxisLabel(*args, axis_direction='bottom', axis=None, **kwargs)[исходный код]

Базовые классы: AttributeCopier, LabelBase

Подпись оси. Производный класс Text. Положение текста обновляется на лету, поэтому изменение положения текста не имеет эффекта. В остальном свойства можно изменять так же, как у обычного объекта Text.

Чтобы изменить отступ между метками делений и подписью оси, используйте set_pad.

draw(renderer)[исходный код]

Отрисовать Artist (и его дочерние элементы) с помощью заданного средства отрисовки.

Ничего не происходит, если Artist не виден (метод Artist.get_visible возвращает False).

Параметры:

rendererподкласс RendererBase.

Примечания

Этот метод переопределён в подклассах Artist.

get_color()[исходный код]

Возвращает цвет текста.

get_pad()[исходный код]

Возвращает внутренний отступ в пунктах.

Подробнее см. set_pad.

get_ref_artist()[исходный код]

Возвращает базовый Artist, который фактически определяет некоторые свойства (например, цвет) этого Artist.

get_text()[исходный код]

Возвращает текстовую строку.

get_window_extent(renderer=None)[исходный код]

Возвращает ограничивающий текст объект Bbox в единицах отображения.

Помимо внутреннего использования, это полезно для задания кликабельных областей в png-файле на веб-странице.

Параметры:

rendererRenderer, необязательный

Для вычисления ограничивающего прямоугольника требуется средство отрисовки. Если Artist уже был отрисован, средство отрисовки кэшируется; поэтому передавать этот аргумент нужно только при вызове get_window_extent до первой отрисовки. На практике обычно проще сначала запустить отрисовку, например, вызвав draw_without_rendering или plt.show().

dpifloat, необязательный

Значение dpi для вычисления bbox; по умолчанию self.get_figure(root=True).dpi (это не dpi средства отрисовки). Его следует задать, например, если нужно сопоставить области с рисунком, сохранённым с пользовательским значением dpi.

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>)[исходный код]

Задать несколько свойств одновременно.

Поддерживаются следующие свойства:

Свойство	Описание
agg_filter	функция фильтра, принимающая массив float размера (m, n, 3) и значение dpi и возвращающая массив размера (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	float или None
animated	bool
antialiased	bool
axis_direction	{"left", "bottom", "right", "top"}
backgroundcolor	цвет
bbox	dict со свойствами для patches.FancyBboxPatch
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
color или c	цвет
default_alignment	{"left", "bottom", "right", "top"}
default_angle	{"left", "bottom", "right", "top"}
figure	Figure или SubFigure
fontfamily или family или fontname	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties или font или font_properties	font_manager.FontProperties или str или pathlib.Path
fontsize или size	float или {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch или stretch	{числовое значение в диапазоне 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
fontstyle или style	{'normal', 'italic', 'oblique'}
fontvariant или variant	{'normal', 'small-caps'}
fontweight или weight	{числовое значение в диапазоне 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
gid	str
horizontalalignment или ha	{'left', 'center', 'right'}
in_layout	bool
label	object
linespacing	float (кратное размеру шрифта)
math_fontfamily	str
mouseover	bool
multialignment или ma	{'left', 'right', 'center'}
pad	float
parse_math	bool
path_effects	список объектов AbstractPathEffect
picker	None, bool, float или вызываемый объект
position	(float, float)
rasterized	bool
rotation	float или {'vertical', 'horizontal'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
text	object
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool, по умолчанию: rcParams["text.usetex"] (по умолчанию: False)
verticalalignment или va	{'baseline', 'bottom', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	float
y	float
zorder	float

set_axis_direction(d)[исходный код]

Настроить угол текста и выравнивание подписи оси в соответствии с соглашениями matplotlib.

Свойство	слева	снизу	справа	сверху
угол подписи оси	180	0	0	180
выравнивание подписи оси по вертикали (va)	center	top	center	bottom
выравнивание подписи оси по горизонтали (ha)	right	center	right	center

Обратите внимание: углы текста отсчитываются относительно (90 + угол направления к метке деления); для нижней оси это значение равно 0.

Параметры:

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

set_default_alignment(d)[исходный код]

Задать выравнивание по умолчанию. Подробности см. в set_axis_direction.

Параметры:

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

set_default_angle(d)[исходный код]

Задать угол по умолчанию. Подробности см. в set_axis_direction.

Параметры:

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

set_pad(pad)[исходный код]

Задать внутренний отступ в пунктах.

Фактический отступ будет равен сумме внутреннего и внешнего отступов (последний задаётся автоматически объектом AxisArtist).

Параметры:

padfloat

Внутренний отступ в пунктах.