matplotlib.pyplot.margins

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

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

Отступ, добавляемый к каждому пределу Axes, равен margin, умноженному на интервал данных. Все входные параметры должны быть числами с плавающей точкой, большими -0,5. Передача как позиционных, так и ключевых аргументов недопустима и вызовет ошибку TypeError. Если аргументы (позиционные или иные) не указаны, текущие поля останутся неизменными и будут просто возвращены.

Установка изменений поля влияет только на автомасштабирование; например, если xmargin не равно None, то xmargin умноженное на интервал данных X будет добавлено к каждому концу этого интервала перед его использованием в автомасштабировании.

Parameters:

*marginsfloat, optional

Если указан единственный позиционный аргумент, он определяет оба поля пределов осей x и y. Если указаны два позиционных аргумента, они будут интерпретированы как xmargin, ymargin. Если требуется установить поле для одной оси, используйте ключевые аргументы, описанные ниже.

x, yfloat, optional

Значения поля соответственно для оси x и оси y. Их нельзя использовать с позиционными аргументами, но можно использовать по отдельности, чтобы изменить, например, только ось y.

tightbool or None, default: True

Параметр tight передается в autoscale_view, который выполняется после изменения поля; по умолчанию здесь True, предполагается, что при указании полей обычно не требуется дополнительный отступ для соответствия отметкам. Установка tight в None сохраняет предыдущее значение.

Returns:

xmargin, ymarginfloat

Notes

Примечание

Это обёртка pyplot wrapper для axes.Axes.margins.

Если ранее используемый метод Axes, такой как pcolor(), установил use_sticky_edges в True, будут изменены только пределы, не заданные «привязанными элементами». Чтобы принудительно установить все поля, установите use_sticky_edges в False перед вызовом margins().

Примеры использования matplotlib.pyplot.margins

Управление пределами просмотра с помощью полей и sticky_edges

Управление пределами просмотра с помощью полей и sticky_edges