mpl_toolkits.axisartist.axis_artist
Модуль axis_artist реализует пользовательские artists для рисования элементов осей (линий и подписей осей, линий и подписей делений, линий сетки).
Линиями и подписями осей, а также линиями и подписями делений управляет класс AxisArtist; линиями сетки управляет класс GridlinesCollection.
Для каждой оси предусмотрен один объект AxisArtist; к нему можно обратиться через словарь axis родительского объекта Axes (который должен быть объектом mpl_toolkits.axislines.Axes), например, ax.axis["bottom"].
К дочерним элементам AxisArtist обращаются как к атрибутам: .line и .label для линии и подписи оси, .major_ticks, .major_ticklabels, .minor_ticks, .minor_ticklabels для линий и подписей делений (например, ax.axis["bottom"].line).
Свойства дочерних элементов (цвета, шрифты, ширину линий и т. д.) можно задавать с помощью методов установки, например:
# Make the major ticks of the bottom axis red.
ax.axis["bottom"].major_ticks.set_color("red")
Однако такие параметры, как расположение делений и их подписи, нужно изменять через grid_helper.
axis_direction
У AxisArtist, AxisLabel и TickLabels есть атрибут axis_direction, который задает расположение, угол и т. д. Значение axis_direction должно быть одним из "left", "right", "bottom", "top" и соответствует принятому в Matplotlib соглашению для прямоугольных осей.
Например, для оси bottom (левое и правое направления отсчитываются относительно направления возрастания координаты):
- подписи делений и подпись оси расположены справа
- угол текста подписей делений и подписи оси равен 0
- подписи делений выровнены по базовой линии и центру
- подпись оси расположена сверху и выровнена по центру
Углы текста фактически отсчитываются относительно (90 + угол направления к подписи деления); для нижней оси это дает 0.
Свойство | слева | снизу | справа | сверху |
|---|---|---|---|---|
расположение подписи деления | слева | справа | справа | слева |
расположение подписи оси | слева | справа | справа | слева |
угол подписи деления | 90 | 0 | -90 | 180 |
угол подписи оси | 180 | 0 | 0 | 180 |
вертикальное выравнивание подписи деления | по центру | по базовой линии | по центру | по базовой линии |
вертикальное выравнивание подписи оси | по центру | сверху | по центру | снизу |
горизонтальное выравнивание подписи деления | справа | по центру | справа | по центру |
горизонтальное выравнивание подписи оси | справа | по центру | справа | по центру |
По умолчанию деления расположены на стороне, противоположной подписям делений. Чтобы расположить деления с той же стороны, что и подписи делений:
ax.axis["bottom"].major_ticks.set_tick_out(True)
Можно настроить следующие атрибуты (используйте методы set_xxx):
-
Ticks: ticksize, tick_out -
TickLabels: pad -
AxisLabel: pad
Классы
| Artist, рисующий линию оси (линию, вдоль которой координата n-й оси постоянна), деления, подписи делений и подпись оси. |
| Подпись оси. |
| Коллекция линий сетки. |
| Базовый класс для |
| Подписи делений. |
| Деления наследуются от |
© 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.html