matplotlib.pyplot.margins

matplotlib.pyplot.margins(*margins, x=None, y=None, tight=True)[исходный код]

Задать или получить отступы вокруг данных для автоматического масштабирования пределов осей.

Это позволяет настроить отступ вокруг данных, не задавая явные пределы с помощью set_xlim / set_ylim.

При автоматическом масштабировании пределы осей определяются добавлением отступа, равного интервалу данных, умноженному на margin. См. иллюстрацию ниже:

(Source code, png)

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

Отступы по умолчанию: rcParams["axes.xmargin"] (по умолчанию: 0.05) и rcParams["axes.ymargin"] (по умолчанию: 0.05).

Параметры:

*marginsчисло с плавающей точкой, необязательно

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

x, yчисло с плавающей точкой, необязательно

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

tightbool или None, по умолчанию: True

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

Возвращает:

xmargin, ymarginчисло с плавающей точкой

См. также

Axes.set_xmargin, Axes.set_ymargin

Примечания

Примечание

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

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

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

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

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