matplotlib.axis

Содержание

Наследование
Объекты Axis
Объекты Tick

Классы для делений и осей x и y.

Наследование

`Axis` объекты

classmatplotlib.axis.Axis(axes, *, pickradius=15, clear=True)[исходный код]

Базовый класс для XAxis и YAxis.

Атрибуты:

isDefault_labelbool
axesAxes: Экземпляр Axes, которому принадлежит художник, или None.
majorTicker: Определяет положения основных делений и формат их подписей.
minorTicker: Определяет положения дополнительных делений и формат их подписей.
callbacksCallbackRegistry
labelText: Подпись оси.
labelpadfloat: Расстояние между подписью оси и подписями делений. По умолчанию rcParams["axes.labelpad"] (значение по умолчанию: 4.0).
offsetTextText: Объект Text, содержащий смещение данных для делений (если оно есть).
pickradiusfloat: Радиус допуска для проверок принадлежности.
majorTicksсписок из Tick: Основные деления.

Предупреждение

Постоянство делений не гарантируется. Различные операции могут создавать, удалять и изменять экземпляры Tick. Есть существенный риск, что изменения отдельных делений не сохранятся при дальнейшей работе с рисунком (в том числе при панорамировании и масштабировании отображаемого рисунка).

Работа с отдельными делениями — крайняя мера. По возможности вместо этого используйте set_tick_params.
minorTicksсписок из Tick: Дополнительные деления.

Параметры:

axesAxes: Объект Axes, которому принадлежит создаваемая ось Axis.
pickradiusfloat: Радиус допуска для проверок принадлежности. См. также Axis.contains.
clearbool, по умолчанию: True: Следует ли очищать ось Axis при создании. Это не требуется, например, при создании Axis как части Axes, поскольку Axes.clear вызовет Axis.clear. .. versionadded:: 3.8

classmatplotlib.axis.XAxis(*args, **kwargs)[исходный код]

Параметры:

axesAxes: Объект Axes, которому принадлежит создаваемая ось Axis.
pickradiusfloat: Радиус допуска для проверок принадлежности. См. также Axis.contains.
clearbool, по умолчанию: True: Следует ли очищать ось Axis при создании. Это не требуется, например, при создании Axis как части Axes, поскольку Axes.clear вызовет Axis.clear. .. versionadded:: 3.8

classmatplotlib.axis.YAxis(*args, **kwargs)[исходный код]

Параметры:

axesAxes: Объект Axes, которому принадлежит создаваемая ось Axis.
pickradiusfloat: Радиус допуска для проверок принадлежности. См. также Axis.contains.
clearbool, по умолчанию: True: Следует ли очищать ось Axis при создании. Это не требуется, например, при создании Axis как части Axes, поскольку Axes.clear вызовет Axis.clear. .. versionadded:: 3.8

classmatplotlib.axis.Ticker[исходный код]

Контейнер для объектов, задающих положение и формат делений.

Атрибуты:

locatorподкласс Locator: Определяет положения делений.
formatterподкласс Formatter: Определяет формат подписей делений.

`Axis.clear`	Очистить ось.
`Axis.get_scale`	Возвращает масштаб этой оси Axis (в виде строки).

Форматировщики и локаторы

`Axis.get_major_formatter`	Получить форматировщик основных делений.
`Axis.get_major_locator`	Получить локатор основных делений.
`Axis.get_minor_formatter`	Получить форматировщик дополнительных делений.
`Axis.get_minor_locator`	Получить локатор дополнительных делений.
`Axis.set_major_formatter`	Задать форматировщик основных делений.
`Axis.set_major_locator`	Задать локатор основных делений.
`Axis.set_minor_formatter`	Задать форматировщик дополнительных делений.
`Axis.set_minor_locator`	Задать локатор дополнительных делений.
`Axis.remove_overlapping_locs`	Следует ли удалять положения дополнительных делений, совпадающие с положениями основных делений.
`Axis.get_remove_overlapping_locs`
`Axis.set_remove_overlapping_locs`

Подпись оси

`Axis.label`	Объект `Text` подписи оси.
`Axis.set_label_coords`	Задать координаты подписи.
`Axis.set_label_position`	Задать положение подписи (сверху или снизу).
`Axis.set_label_text`	Задать текст подписи оси.
`Axis.get_label_position`	Возвращает положение подписи (сверху или снизу).
`Axis.get_label_text`	Получить текст подписи.

Деления, их подписи и текст смещения

`Axis.get_major_ticks`	Возвращает список основных делений `Tick`.
`Axis.get_majorticklabels`	Возвращает подписи основных делений этой оси Axis в виде списка объектов `Text`.
`Axis.get_majorticklines`	Возвращает линии основных делений этой оси Axis в виде списка объектов `Line2D`.
`Axis.get_majorticklocs`	Возвращает положения основных делений этой оси Axis в координатах данных.
`Axis.get_minor_ticks`	Возвращает список дополнительных делений `Tick`.
`Axis.get_minorticklabels`	Возвращает подписи дополнительных делений этой оси Axis в виде списка объектов `Text`.
`Axis.get_minorticklines`	Возвращает линии дополнительных делений этой оси Axis в виде списка объектов `Line2D`.
`Axis.get_minorticklocs`	Возвращает положения дополнительных делений этой оси Axis в координатах данных.
`Axis.get_offset_text`	Возвращает текст смещения оси в виде экземпляра Text.
`Axis.get_tick_padding`
`Axis.get_tick_params`	Получить параметры внешнего вида делений, их подписей и линий сетки.
`Axis.get_ticklabels`	Получить подписи делений этой оси Axis.
`Axis.get_ticklines`	Возвращает линии делений этой оси Axis в виде списка объектов `Line2D`.
`Axis.get_ticklocs`	Возвращает положения делений этой оси Axis в координатах данных.
`Axis.get_gridlines`	Возвращает линии сетки этой оси Axis в виде списка объектов `Line2D`.
`Axis.grid`	Настроить линии сетки.
`Axis.set_tick_params`	Задать параметры внешнего вида делений, их подписей и линий сетки.
`Axis.axis_date`	Настроить деления и подписи оси так, чтобы данные вдоль этой оси Axis трактовались как даты.
`Axis.minorticks_off`	Удалить дополнительные деления с оси Axis.
`Axis.minorticks_on`	Показать стандартные дополнительные деления на оси Axis в зависимости от масштаба (`get_scale`).

Интервалы данных и отображения

`Axis.get_data_interval`	Возвращает `(min, max)` пределы данных этой оси.
`Axis.get_view_interval`	Возвращает `(min, max)` пределы отображения этой оси.
`Axis.get_inverted`	Возвращает, ориентирована ли эта ось в «обратном» направлении.
`Axis.set_data_interval`	Задать пределы данных оси.
`Axis.set_view_interval`	Задать пределы отображения оси.
`Axis.set_inverted`	Задать, должна ли эта ось быть ориентирована в «обратном» направлении.

Вспомогательные средства отрисовки

`Axis.get_minpos`
`Axis.get_tick_space`	Возвращает оценочное количество делений, помещающихся на оси.
`Axis.get_tightbbox`	Возвращает ограничивающую рамку, охватывающую ось.

Интерактивное взаимодействие

`Axis.contains`	Проверить, содержит ли художник событие мыши.
`Axis.pickradius`	Радиус допуска для проверок принадлежности.
`Axis.get_pickradius`	Возвращает глубину оси, используемую средством выбора.
`Axis.set_pickradius`	Задать глубину оси, используемую средством выбора.

Единицы измерения

`Axis.convert_units`
`Axis.set_units`	Задать единицы измерения для оси.
`Axis.get_units`	Возвращает единицы измерения оси.
`Axis.set_converter`	Задать преобразователь единиц измерения для оси.
`Axis.get_converter`	Получить преобразователь единиц измерения для оси.
`Axis.update_units`	Определяет единицы измерения для data и при необходимости обновляет экземпляр `axis.get_converter`.

Особенности XAxis

`XAxis.axis_name`	Имя оси, доступное только для чтения.
`XAxis.get_ticks_position`	Возвращает положение делений («сверху», «снизу», «по умолчанию» или «неизвестно»).
`XAxis.set_ticks_position`	Задать положение делений.
`XAxis.set_label_position`	Задать положение подписи (сверху или снизу).
`XAxis.tick_bottom`	Переместить деления и их подписи (если есть) вниз области Axes.
`XAxis.tick_top`	Переместить деления и их подписи (если есть) вверх области Axes.

Особенности оси Y

`YAxis.axis_name`	Доступное только для чтения имя, идентифицирующее ось.
`YAxis.get_ticks_position`	Возвращает положение делений ("left", "right", "default" или "unknown").
`YAxis.set_offset_position`
`YAxis.set_ticks_position`	Задаёт положение делений.
`YAxis.set_label_position`	Задаёт положение подписи (слева или справа)
`YAxis.tick_left`	Перемещает деления и подписи делений (если есть) влево от Axes.
`YAxis.tick_right`	Перемещает деления и подписи делений (если есть) вправо от Axes.

Прочее

`Axis.OFFSETTEXTPAD`
`Axis.axes`	Экземпляр `Axes`, в котором находится этот объект Artist, или None.
`Axis.limit_range_for_scale`	Возвращает диапазон vmin, vmax, ограниченный областью, поддерживаемой текущей шкалой.
`Axis.reset_ticks`	Повторно инициализирует списки основных и дополнительных делений.
`Axis.set_clip_path`	Задаёт контур отсечения объекта Artist.
`Axis.set_default_intervals`	Задаёт пределы по умолчанию для данных оси и интервала отображения, если они ещё не изменялись.

Не рекомендуется

Эти методы следует использовать совместно с осторожностью: сначала вызовите set_ticks, чтобы задать требуемые положения делений, прежде чем вызывать set_ticklabels для задания соответствующего набора подписей. Вызов set_ticks создаёт FixedLocator; список его положений затем используется методом set_ticklabels для создания подходящего FuncFormatter.

`Axis.get_label`	Возвращает подпись оси в виде экземпляра Text.
`Axis.set_label`	Назначение подписей легенды не поддерживается.
`Axis.set_ticks`	Задаёт положения делений этой оси и, при необходимости, их подписи.
`Axis.set_ticklabels`	[Не рекомендуется] Задаёт подписи делений этой оси с помощью списка строк.

`Tick` объекты

classmatplotlib.axis.Tick(axes, loc, *, size=None, width=None, color=None, tickdir=None, pad=None, labelsize=None, labelcolor=None, labelfontfamily=None, zorder=None, gridOn=None, tick1On=True, tick2On=True, label1On=True, label2On=False, major=True, labelrotation=0, grid_color=None, grid_linestyle=None, grid_linewidth=None, grid_alpha=None, **kwargs)[исходный код]

Абстрактный базовый класс для делений оси, линий сетки и подписей.

Деления обозначают положения на оси. Они содержат две линии-маркера и две подписи: по одной для нижнего и верхнего положения (для XAxis) или для левого и правого положения (для YAxis).

Атрибуты:

tick1lineLine2D: Маркер деления слева/снизу.
tick2lineLine2D: Маркер деления справа/сверху.
gridlineLine2D: Линия сетки, соответствующая положению подписи.
label1Text: Подпись деления слева/снизу.
label2Text: Подпись деления справа/сверху.

bbox — это ограничивающая рамка Bound2D в координатах отображения Axes; loc — положение деления в координатах данных; size — размер деления в пунктах

classmatplotlib.axis.XTick(*args, **kwargs)[исходный код]

Содержит все объекты Artist, необходимые для создания деления оси x: линию деления, текст подписи и линию сетки

classmatplotlib.axis.YTick(*args, **kwargs)[исходный код]

Содержит все объекты Artist, необходимые для создания деления оси Y: линию деления, текст подписи и линию сетки

`Tick.get_loc`	Возвращает положение деления (в координатах данных) в виде скалярного значения.
`Tick.get_pad`	Возвращает величину отступа подписи деления в пунктах.
`Tick.get_tick_padding`	Возвращает длину части деления, выходящей за пределы Axes.
`Tick.get_tickdir`
`Tick.get_view_interval`	Возвращает пределы отображения `(min, max)` оси, которой принадлежит деление.
`Tick.set_clip_path`	Задаёт контур отсечения объекта Artist.
`Tick.set_pad`	Задаёт отступ подписи деления в пунктах
`Tick.set_url`	Задаёт URL для label1 и label2.
`Tick.update_position`	Задаёт положение деления в координатах данных с помощью скалярного значения loc.

matplotlib.axis

Наследование

Axis объекты

Форматировщики и локаторы

Подпись оси

Деления, их подписи и текст смещения

Интервалы данных и отображения

Вспомогательные средства отрисовки

Интерактивное взаимодействие

Единицы измерения

Особенности XAxis

Особенности оси Y

Прочее

Не рекомендуется

Tick объекты

`Axis` объекты

`Tick` объекты