mpl_toolkits.axisartist.axis_artist.AxisArtist
- classmpl_toolkits.axisartist.axis_artist.AxisArtist(axes, helper, offset=None, axis_direction='bottom', **kwargs)[исходный код]
-
Базовые классы:
ArtistОбъект Artist, который рисует линию оси (линию, вдоль которой координата n-й оси постоянна), деления, подписи делений и подпись оси.
- Параметры:
-
-
axes
mpl_toolkits.axisartist.axislines.Axes -
helper
AxisArtistHelper
-
axes
- propertyLABELPAD
- draw(renderer)[исходный код]
-
Нарисовать объект Artist (и его дочерние элементы) с помощью указанного средства визуализации.
Ничего не делает, если объект Artist невидим (
Artist.get_visibleвозвращает False).- Параметры:
-
-
rendererподкласс
RendererBase.
-
rendererподкласс
Примечания
Этот метод переопределяется в подклассах Artist.
- get_axisline_style()[исходный код]
-
Возвращает текущий стиль линии оси.
- get_helper()[исходный код]
-
Возвращает экземпляр вспомогательного объекта Artist оси.
- get_tightbbox(renderer=None)[исходный код]
-
Аналогично
Artist.get_window_extent, но с учётом любого обрезания.- Параметры:
-
-
rendererподкласс
RendererBase, необязательный -
средство визуализации, которое будет использоваться для рисования фигур (т. е.
fig.canvas.get_renderer())
-
rendererподкласс
- Возвращает:
-
-
Bboxили None -
Охватывающая ограничивающая рамка (в пиксельных координатах фигуры). Возвращает None, если в результате обрезания пересечение отсутствует.
-
- get_transform()[исходный код]
-
Возвращает экземпляр
Transform, используемый этим объектом Artist.
- invert_ticklabel_direction()[исходный код]
- set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, axis_direction=<UNSET>, axislabel_direction=<UNSET>, axisline_style=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, mouseover=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, ticklabel_direction=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[исходный код]
-
Задать несколько свойств одновременно.
Поддерживаются следующие свойства:
Свойство
Описание
функция фильтра, принимающая массив float размера (m, n, 3) и значение dpi и возвращающая массив размера (m, n, 3) и два смещения от левого нижнего угла изображения
float или None
bool
{"left", "bottom", "right", "top"}
{"+", "-"}
str или None
BboxBaseили Nonebool
Patch или (Path, Transform) или None
str
bool
неизвестный тип
bool
список объектов
AbstractPathEffectNone, bool, float или вызываемый объект
bool
(scale: float, length: float, randomness: float)
bool или None
{"+", "-"}
str
bool
float
- set_axis_direction(axis_direction)[исходный код]
-
Настроить направление, угол текста и выравнивание текста подписей делений и осей в соответствии с соглашением Matplotlib для прямоугольных осей.
Значение axis_direction должно быть одним из следующих: [left, right, bottom, top].
Свойство
left
bottom
right
top
направление подписей делений
"-"
"+"
"+"
"-"
направление подписи оси
"-"
"+"
"+"
"-"
угол подписей делений
90
0
-90
180
вертикальное выравнивание подписей делений
center
baseline
center
baseline
горизонтальное выравнивание подписей делений
right
center
right
center
угол подписи оси
180
0
0
180
вертикальное выравнивание подписи оси
center
top
center
bottom
горизонтальное выравнивание подписи оси
right
center
right
center
Обратите внимание, что направления "+" и "-" задаются относительно направления возрастания координаты. Кроме того, углы текста фактически отсчитываются относительно (90 + угол направления к подписи деления), что для нижней оси даёт 0.
- Параметры:
-
- axis_direction{"left", "bottom", "right", "top"}
- set_axislabel_direction(label_direction)[исходный код]
-
Настроить направление подписи оси.
Обратите внимание, что направления '+' и '-' для label_direction задаются относительно направления возрастания координаты.
- Параметры:
-
- label_direction{"+", "-"}
- set_axisline_style(axisline_style=None, **kwargs)[исходный код]
-
Задать стиль линии оси.
Новый стиль полностью определяется переданными атрибутами. Существующие атрибуты стиля сбрасываются.
- Параметры:
-
- axisline_stylestr или None
-
Стиль линии, например '->', за которым при необходимости следует список атрибутов, разделённых запятыми. Также атрибуты можно передать в виде ключевых аргументов.
Если значение равно None, возвращает строку с доступными стилями.
Примеры
Следующие две команды эквивалентны:
>>> set_axisline_style("->,size=1.5") >>> set_axisline_style("->", size=1.5)
- set_label(s)[исходный код]
-
Задать подпись, которая будет отображаться в легенде.
- Параметры:
-
- sobject
-
s будет преобразовано в строку вызовом
str.
- set_ticklabel_direction(tick_direction)[исходный код]
-
Настроить направление подписей делений.
Обратите внимание, что направления '+' и '-' для tick_direction задаются относительно направления возрастания координаты.
- Параметры:
-
- tick_direction{"+", "-"}
- toggle(all=None, ticks=None, ticklabels=None, label=None)[исходный код]
-
Переключить видимость делений, их подписей и подписи (оси). Чтобы отключить всё:
axis.toggle(all=False)
Чтобы отключить всё, кроме делений:
axis.toggle(all=False, ticks=True)
Чтобы включить всё, кроме подписи (оси):
axis.toggle(all=True, label=False)
- zorder=2.5
Примеры использования mpl_toolkits.axisartist.axis_artist.AxisArtist
© 2012–2026 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/_as_gen/mpl_toolkits.axisartist.axis_artist.AxisArtist.html