matplotlib.axis
Оглавление
Классы для делений и осей X и Y.
Наследование
Axis объекты
- классmatplotlib.axis.Axis(axes, *, pickradius=15, clear=True)[source]
-
Базовый класс для
XAxisиYAxis.- Атрибуты:
-
- isDefault_labelbool
-
axesAxes -
Экземпляр
Axes, в котором находится элемент, или None. -
major
Ticker -
Определяет позиции основных делений шкалы и формат их меток.
-
minor
Ticker -
Определяет позиции дополнительных делений шкалы и формат их меток.
-
callbacks
CallbackRegistry -
label
Text -
Метка оси.
- labelpadfloat
-
Расстояние между меткой оси и метками делений. По умолчанию
rcParams["axes.labelpad"](по умолчанию4.0) = 4. -
offsetText
Text -
Объект
Text, содержащий смещение данных для делений (если есть). -
pickradiusfloat -
Радиус для проверки принадлежности к области.
-
majorTicksсписок
Tick -
Основные деления.
Предупреждение
Деления не гарантируют сохранение состояния. Различные операции могут создавать, удалять и изменять экземпляры делений. Существует вероятность, что изменения отдельных делений не сохранятся при дальнейшем работе с графиком (включая перемещение/изменение масштаба на отображаемом графике).
Работа с отдельными делениями — крайний случай. Используйте
set_tick_params, если это возможно. -
minorTicksсписок
Tick -
Дополнительные деления.
- Параметры:
-
-
axes
Axes -
Объект
Axes, к которому принадлежит создаваемая ось. - pickradiusfloat
-
Радиус для проверки принадлежности к области. См. также
Axis.contains. - clearbool, по умолчанию: True
-
Очистить ось при создании. Это не обязательно, например, при создании оси как части Axes, так как
Axes.clearвызоветAxis.clear. .. versionadded:: 3.8
-
axes
- классmatplotlib.axis.XAxis(*args, **kwargs)[source]
-
- Параметры:
-
-
axes
Axes -
Объект
Axes, к которому принадлежит создаваемая ось. - pickradiusfloat
-
Радиус для проверки принадлежности к области. См. также
Axis.contains. - clearbool, по умолчанию: True
-
Очистить ось при создании. Это не обязательно, например, при создании оси как части Axes, так как
Axes.clearвызоветAxis.clear. .. versionadded:: 3.8
-
axes
- классmatplotlib.axis.YAxis(*args, **kwargs)[source]
-
- Параметры:
-
-
axes
Axes -
Объект
Axes, к которому принадлежит создаваемая ось. - pickradiusfloat
-
Радиус для проверки принадлежности к области. См. также
Axis.contains. - clearbool, по умолчанию: True
-
Очистить ось при создании. Это не обязательно, например, при создании оси как части Axes, так как
Axes.clearвызоветAxis.clear. .. versionadded:: 3.8
-
axes
- классmatplotlib.axis.Ticker[source]
-
Контейнер для объектов, определяющих позиции и формат делений.
- Атрибуты:
-
-
locatorподкласс
Locator -
Определяет позиции делений.
-
formatterподкласс
Formatter -
Определяет формат меток делений.
-
locatorподкласс
Очистить ось. | |
Возвращает масштаб этой оси (как строку). |
Форматтеры и локеры
Получить форматтер для основных делений. | |
Получить локатор для основных делений. | |
Получить форматтер для вспомогательных делений. | |
Получить локатор для вспомогательных делений. | |
Установить форматтер для основных делений. | |
Установить локатор для основных делений. | |
Установить форматтер для вспомогательных делений. | |
Установить локатор для вспомогательных делений. | |
Убрать наложение вспомогательных делений на основные. | |
Подписи осей
Установить координаты подписи. | |
Установить положение подписи (верх или низ) | |
Установить текст подписи оси. | |
Возвращает подпись оси как объект Text. | |
Возвращает положение подписи (верх или низ) | |
Получить текст подписи. |
Деления, метки делений и текст смещения
Возвращает список основных делений | |
Возвращает метки основных делений оси, как список объектов | |
Возвращает линии основных делений оси как список объектов | |
Возвращает позиции основных делений в координатах данных. | |
Возвращает список вспомогательных делений | |
Возвращает метки вспомогательных делений оси, как список объектов | |
Возвращает линии вспомогательных делений оси как список объектов | |
Возвращает позиции вспомогательных делений в координатах данных. | |
Возвращает текст смещения оси как объект Text. | |
Получить параметры отображения делений, меток и линий сетки. | |
Получить метки делений. | |
Возвращает линии делений как список объектов | |
Возвращает позиции делений в координатах данных. | |
Возвращает линии сетки как список объектов | |
Настроить линии сетки. | |
Установить параметры отображения делений, меток и линий сетки. | |
Настроить деления и метки оси для обработки данных как дат. |
Диапазоны данных и отображения
Возвращает пределы данных для данной оси. | |
Возвращает пределы отображения для данной оси. | |
Возвращает значение, указывающее, ориентирована ли ось в "обратном" направлении. | |
Устанавливает пределы данных оси. | |
Устанавливает пределы отображения оси. | |
Устанавливает значение, указывающее, ориентирована ли ось в "обратном" направлении. |
Вспомогательные функции отрисовки
Возвращает приблизительное количество делений, которое может уместиться на оси. | |
Возвращает область, охватывающую ось. |
Интерактивное взаимодействие
Проверка, содержит ли элемент графический объект указанное событие мыши. | |
Радиус принятия для тестов на включение. | |
Возвращает глубину оси, используемой пикером. | |
Устанавливает глубину оси, используемой пикером. |
Единицы измерения
Устанавливает единицы измерения для оси. | |
Возвращает единицы измерения для оси. | |
Проверяет данные на наличие конвертера единиц измерения и обновляет экземпляр, если необходимо. |
Специфика оси X
Имя оси (только для чтения). | |
Возвращает положение делений ("верх", "низ", "по умолчанию" или "неизвестно"). | |
Устанавливает положение делений. | |
Устанавливает положение подписи (верх или низ). | |
Перемещает деления и подписи (если они присутствуют) в нижнюю часть области. | |
Перемещает деления и подписи (если они присутствуют) в верхнюю часть области. |
Специфика оси Y
Имя оси (только для чтения). | |
Возвращает положение делений ("слева", "справа", "по умолчанию" или "неизвестно"). | |
| |
Устанавливает положение делений. | |
Устанавливает положение подписи (слева или справа). | |
Перемещает деления и подписи (если они присутствуют) влево от области. | |
Перемещает деления и подписи (если они присутствуют) вправо от области. |
Прочие
Экземпляр | |
Переинициализирует списки основных и дополнительных делений. | |
Устанавливает стандартные пределы для диапазонов данных и отображения оси, если они еще не изменены. |
Отказано от использования
Эти методы следует использовать с осторожностью, вызывая set_ticks для указания желаемых расположений делений перед вызовом set_ticklabels для указания соответствующего набора меток. Вызов set_ticks создаёт FixedLocator; список его расположений затем используется set_ticklabels для создания соответствующего FuncFormatter.
Устанавливает расположения делений оси и, необязательно, метки делений. | |
[Отказано от использования] Устанавливает метки делений оси с помощью списка строковых меток. |
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).- Атрибуты:
-
-
tick1line
Line2D -
Маркер левого/нижнего деления.
-
tick2line
Line2D -
Маркер правого/верхнего деления.
-
gridline
Line2D -
Линия сетки, связанная с позицией метки.
-
label1
Text -
Метка левого/нижнего деления.
-
label2
Text -
Метка правого/верхнего деления.
-
tick1line
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 — размер деления в пунктах.
Возвращает расположение деления (координаты данных) как скаляр. | |
Получает значение отступа метки деления в пунктах. | |
Возвращает длину отметки вне оси. | |
Возвращает пределы отображения | |
[Устарело] Устанавливает текст метки label1. | |
[Устарело] Устанавливает текст метки label2. | |
Устанавливает отступ метки деления в пунктах | |
Устанавливает URL метки label1 и label2. | |
Устанавливает расположение деления в координатах данных со скаляром 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