Spec-Zone.ru › Matplotlib 3.8

matplotlib.axis

Оглавление

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

    • Форматтеры и локейторы
    • Метка оси
    • Деления, метки делений и текст смещения
    • Интервалы данных и отображения
    • Вспомогательные средства отрисовки
    • Интерактивность
    • Единицы
    • Уточнения для оси X
    • Уточнения для оси Y
    • Прочее
    • Отказано от использования
  • Tick объекты

Классы для делений и осей X и Y.

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

Inheritance diagram of Tick, Ticker, XAxis, YAxis, XTick, YTick

Axis объекты

классmatplotlib.axis.Axis(axes, *, pickradius=15, clear=True)[source]

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

Атрибуты:
isDefault_labelbool
axesAxes

Экземпляр Axes, в котором находится элемент, или None.

majorTicker

Определяет позиции основных делений шкалы и формат их меток.

minorTicker

Определяет позиции дополнительных делений шкалы и формат их меток.

callbacksCallbackRegistry
labelText

Метка оси.

labelpadfloat

Расстояние между меткой оси и метками делений. По умолчанию rcParams["axes.labelpad"] (по умолчанию 4.0) = 4.

offsetTextText

Объект Text, содержащий смещение данных для делений (если есть).

pickradiusfloat

Радиус для проверки принадлежности к области.

majorTicksсписок Tick

Основные деления.

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

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

Работа с отдельными делениями — крайний случай. Используйте set_tick_params, если это возможно.

minorTicksсписок Tick

Дополнительные деления.

Параметры:
axesAxes

Объект Axes, к которому принадлежит создаваемая ось.

pickradiusfloat

Радиус для проверки принадлежности к области. См. также Axis.contains.

clearbool, по умолчанию: True

Очистить ось при создании. Это не обязательно, например, при создании оси как части Axes, так как Axes.clear вызовет Axis.clear. .. versionadded:: 3.8

классmatplotlib.axis.XAxis(*args, **kwargs)[source]
Параметры:
axesAxes

Объект Axes, к которому принадлежит создаваемая ось.

pickradiusfloat

Радиус для проверки принадлежности к области. См. также Axis.contains.

clearbool, по умолчанию: True

Очистить ось при создании. Это не обязательно, например, при создании оси как части Axes, так как Axes.clear вызовет Axis.clear. .. versionadded:: 3.8

классmatplotlib.axis.YAxis(*args, **kwargs)[source]
Параметры:
axesAxes

Объект Axes, к которому принадлежит создаваемая ось.

pickradiusfloat

Радиус для проверки принадлежности к области. См. также Axis.contains.

clearbool, по умолчанию: True

Очистить ось при создании. Это не обязательно, например, при создании оси как части Axes, так как Axes.clear вызовет Axis.clear. .. versionadded:: 3.8

классmatplotlib.axis.Ticker[source]

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

Атрибуты:
locatorподкласс Locator

Определяет позиции делений.

formatterподкласс Formatter

Определяет формат меток делений.

Axis.clear

Очистить ось.

Axis.get_scale

Возвращает масштаб этой оси (как строку).

Форматтеры и локеры

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.set_label_coords

Установить координаты подписи.

Axis.set_label_position

Установить положение подписи (верх или низ)

Axis.set_label_text

Установить текст подписи оси.

Axis.get_label

Возвращает подпись оси как объект Text.

Axis.get_label_position

Возвращает положение подписи (верх или низ)

Axis.get_label_text

Получить текст подписи.

Деления, метки делений и текст смещения

Axis.get_major_ticks

Возвращает список основных делений Tick.

Axis.get_majorticklabels

Возвращает метки основных делений оси, как список объектов Text.

Axis.get_majorticklines

Возвращает линии основных делений оси как список объектов Line2D.

Axis.get_majorticklocs

Возвращает позиции основных делений в координатах данных.

Axis.get_minor_ticks

Возвращает список вспомогательных делений Tick.

Axis.get_minorticklabels

Возвращает метки вспомогательных делений оси, как список объектов Text.

Axis.get_minorticklines

Возвращает линии вспомогательных делений оси как список объектов Line2D.

Axis.get_minorticklocs

Возвращает позиции вспомогательных делений в координатах данных.

Axis.get_offset_text

Возвращает текст смещения оси как объект Text.

Axis.get_tick_padding

Axis.get_tick_params

Получить параметры отображения делений, меток и линий сетки.

Axis.get_ticklabels

Получить метки делений.

Axis.get_ticklines

Возвращает линии делений как список объектов Line2D.

Axis.get_ticklocs

Возвращает позиции делений в координатах данных.

Axis.get_gridlines

Возвращает линии сетки как список объектов Line2D.

Axis.grid

Настроить линии сетки.

Axis.set_tick_params

Установить параметры отображения делений, меток и линий сетки.

Axis.axis_date

Настроить деления и метки оси для обработки данных как дат.

Диапазоны данных и отображения

Axis.get_data_interval

Возвращает пределы данных для данной оси.

Axis.get_view_interval

Возвращает пределы отображения для данной оси.

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.update_units

Проверяет данные на наличие конвертера единиц измерения и обновляет экземпляр, если необходимо.

Специфика оси X

XAxis.axis_name

Имя оси (только для чтения).

XAxis.get_ticks_position

Возвращает положение делений ("верх", "низ", "по умолчанию" или "неизвестно").

XAxis.set_ticks_position

Устанавливает положение делений.

XAxis.set_label_position

Устанавливает положение подписи (верх или низ).

XAxis.tick_bottom

Перемещает деления и подписи (если они присутствуют) в нижнюю часть области.

XAxis.tick_top

Перемещает деления и подписи (если они присутствуют) в верхнюю часть области.

Специфика оси Y

YAxis.axis_name

Имя оси (только для чтения).

YAxis.get_ticks_position

Возвращает положение делений ("слева", "справа", "по умолчанию" или "неизвестно").

YAxis.set_offset_position

Параметры:

YAxis.set_ticks_position

Устанавливает положение делений.

YAxis.set_label_position

Устанавливает положение подписи (слева или справа).

YAxis.tick_left

Перемещает деления и подписи (если они присутствуют) влево от области.

YAxis.tick_right

Перемещает деления и подписи (если они присутствуют) вправо от области.

Прочие

Axis.OFFSETTEXTPAD

Axis.axes

Экземпляр Axes, в котором находится объект, или None.

Axis.limit_range_for_scale

Axis.reset_ticks

Переинициализирует списки основных и дополнительных делений.

Axis.set_default_intervals

Устанавливает стандартные пределы для диапазонов данных и отображения оси, если они еще не изменены.

Отказано от использования

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

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)[source]

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

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

Атрибуты:
tick1lineLine2D

Маркер левого/нижнего деления.

tick2lineLine2D

Маркер правого/верхнего деления.

gridlineLine2D

Линия сетки, связанная с позицией метки.

label1Text

Метка левого/нижнего деления.

label2Text

Метка правого/верхнего деления.

bbox — прямоугольник Bound2D в координатах отображения Axes, loc — расположение деления в координатах данных, size — размер деления в пунктах.

classmatplotlib.axis.XTick(*args, **kwargs)[source]

Содержит все необходимые элементы для создания отметки по оси X — линию отметки, текстовую метку и линию сетки.

bbox — прямоугольник Bound2D в координатах отображения Axes, loc — расположение деления в координатах данных, size — размер деления в пунктах.

classmatplotlib.axis.YTick(*args, **kwargs)[source]

Содержит все необходимые элементы для создания отметки по оси Y — линию отметки, текстовую метку и линию сетки.

bbox — прямоугольник Bound2D в координатах отображения Axes, loc — расположение деления в координатах данных, size — размер деления в пунктах.

Tick.get_loc

Возвращает расположение деления (координаты данных) как скаляр.

Tick.get_pad

Получает значение отступа метки деления в пунктах.

Tick.get_tick_padding

Возвращает длину отметки вне оси.

Tick.get_tickdir

Tick.get_view_interval

Возвращает пределы отображения (min, max) оси, к которой принадлежит отметка.

Tick.set_label1

[Устарело] Устанавливает текст метки label1.

Tick.set_label2

[Устарело] Устанавливает текст метки label2.

Tick.set_pad

Устанавливает отступ метки деления в пунктах

Tick.set_url

Устанавливает URL метки label1 и label2.

Tick.update_position

Устанавливает расположение деления в координатах данных со скаляром loc.

© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.8.4/api/axis_api.html

Spec-Zone.ru

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