matplotlib.axes.Axes.margins
- Axes.margins(*margins, x=None, y=None, tight=True)[source]
-
Установить или получить поля автомасштабирования.
Отступ, добавляемый к каждому пределу Axes, равен margin умноженному на интервал данных. Все входные параметры должны быть числами с плавающей точкой в диапазоне [0, 1]. Передача позиционных и ключевых аргументов одновременно недопустима и вызовет ошибку TypeError. Если не указаны никакие аргументы (позиционные или другие), текущие поля останутся на месте и просто будут возвращены.
Указание каких-либо изменений полей изменяет только автомасштабирование; например, если xmargin не равно None, то xmargin, умноженный на интервал данных по оси X, будет добавлен к каждому концу этого интервала перед его использованием в автомасштабировании.
- Параметры:
-
- *marginsfloat, необязательно
-
Если в качестве единственного позиционного аргумента указано число, оно задает поля как для осей X, так и для осей Y. Если предоставлено два позиционных аргумента, они будут интерпретироваться как xmargin и ymargin. Если необходимо установить поле только для одной оси, используйте ключевые аргументы, описанные ниже.
- x, yfloat, необязательно
-
Значения поля соответственно для осей X и Y. Их нельзя использовать вместе с позиционными аргументами, но можно использовать по отдельности для изменения, например, только оси Y.
- tightbool или None, по умолчанию: True
-
Параметр tight передается в
autoscale_view, который выполняется после изменения поля; по умолчанию здесь значение True, с предположением, что когда заданы поля, обычно не требуется дополнительный отступ для соответствия отметкам. Установка tight в None сохраняет предыдущее значение.
- Возвращаемое значение:
-
- xmargin, ymarginfloat
Примечания
Если ранее использовавшийся метод Axes, такой как
pcolor(), установилuse_sticky_edgesвTrue, будут изменены только пределы, не установленные «прилипающими элементами». Чтобы принудительно установить все поля, установитеuse_sticky_edgesвFalseперед вызовомmargins().
Примеры использования matplotlib.axes.Axes.margins
Создание временной шкалы с линиями, датами и текстом
Управление пределами области просмотра с помощью полей и sticky_edges
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.6.0/api/_as_gen/matplotlib.axes.Axes.margins.html