Spec-Zone.ru › Matplotlib

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

Классы

AttributeCopier()

AxisArtist(axes, helper[, offset, ...])

Artist, рисующий линию оси (линию, вдоль которой координата 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–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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API