mpl_toolkits.axisartist.axis_artist
Модуль axis_artist реализует пользовательские элементы для отрисовки элементов оси (линии и надписи оси, линии и надписи делений, линии сетки).
Линии и надписи оси, линии и надписи делений управляются классом AxisArtist; линии сетки управляются классом GridlinesCollection.
На одну ось приходится один экземпляр AxisArtist; он доступен через словарь axis родительского объекта Axes (который должен быть объектом mpl_toolkits.axislines.Axes), например ax.axis["bottom"].
Элементы оси доступны как атрибуты: .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 (left и right относительны к направлению возрастания координаты):
- надписи делений и надпись оси находятся справа
- углы надписей делений и надписи оси равны 0
- надписи делений выровнены по основанию, по центру
- надпись оси расположена сверху, по центру
Углы надписей фактически относятся к (90 + углу направления к надписи деления), что дает 0 для оси bottom.
| Параметр | left | bottom | right | top |
|---|---|---|---|---|
| Расположение надписей делений | слева | справа | справа | слева |
| Расположение надписи оси | слева | справа | справа | слева |
| Угол надписей делений | 90 | 0 | -90 | 180 |
| Угол надписи оси | 180 | 0 | 0 | 180 |
| Выравнивание по вертикали (надписи делений) | center | baseline | center | baseline |
| Выравнивание по вертикали (надпись оси) | center | top | center | bottom |
| Выравнивание по горизонтали (надписи делений) | right | center | right | center |
| Выравнивание по горизонтали (надпись оси) | right | center | right | center |
Деления по умолчанию находятся на стороне, противоположной надписям делений. Чтобы сделать деления на той же стороне, что и надписи:
ax.axis["bottom"].major_ticks.set_tick_out(True)
Можно настроить следующие атрибуты (используйте методы set_xxx):
-
Ticks: ticksize, tick_out -
TickLabels: pad -
AxisLabel: pad
Классы
AttributeCopier() | |
AxisArtist(axes, helper[, offset, ...]) | Элемент, который рисует ось (линию, вдоль которой n-я координата оси является постоянной), деления, надписи делений и надпись оси. |
AxisLabel(*args[, axis_direction, axis]) | Надпись оси. |
GridlinesCollection(*args[, which, axis]) | |
LabelBase(*args, **kwargs) | Базовый класс для AxisLabel и TickLabels. |
TickLabels(*[, axis_direction]) | Надписи делений. |
Ticks(ticksize[, tick_out, axis]) | Деления, наследуются от Line2D, и обратите внимание, что сами деления — это метки. |
© 2012–2021 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.4.3/api/_as_gen/mpl_toolkits.axisartist.axis_artist.html