matplotlib.axes.Axes.margins

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

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

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

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

(Source code, 2x.png, png)

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

Поля по умолчанию: rcParams["axes.xmargin"] (по умолчанию: 0.05) и rcParams["axes.ymargin"] (по умолчанию: 0.05).

Параметры:

*marginsfloat, необязательный

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

x, yfloat, необязательный

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

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

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

Возвращает:

xmargin, ymarginfloat

См. также

Axes.set_xmargin, Axes.set_ymargin

Примечания

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

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

Демонстрация Trigradient

Демонстрация Trigradient

Справочник по маркерам

Справочник по маркерам

Временная шкала с линиями, датами и текстом

Временная шкала с линиями, датами и текстом

Таблица стилей ggplot

Таблица стилей ggplot

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

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

Метка угла, инвариантная к масштабу

Метка угла, инвариантная к масштабу

Автоматическое масштабирование осей

Автоматическое масштабирование осей