matplotlib.axes.Axes.margins
- Axes.margins(*margins, x=None, y=None, tight=True)[source]
-
Установить или получить отступы автомасштабирования.
Отступ, добавляемый к каждому пределу Axes, равен margin, умноженному на интервал данных. Все входные параметры должны быть числами с плавающей точкой, большими чем -0,5. Передача позиционных и ключевых аргументов одновременно недопустима и вызовет исключение TypeError. Если не передано никаких аргументов (позиционных или ключевых), текущие отступы останутся неизменными и просто будут возвращены.
Указание любых изменений отступов влияет только на автомасштабирование; например, если xmargin не равен None, то к каждому концу интервала данных X будет добавлено значение 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.8.4/api/_as_gen/matplotlib.axes.Axes.margins.html