matplotlib.axes.Axes.margins

Axes.margins(*margins, x=None, y=None, tight=True)[source]

Установить или получить отступы при автоматическом масштабировании.

Добавляемый отступ к каждому пределу оси — это отступ, умноженный на интервал данных. Все входные параметры должны быть числами с плавающей точкой в диапазоне [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