matplotlib.axes.Axes.margins #

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

Set or retrieve margins around the data for autoscaling axis limits.

This allows to configure the padding around the data without having toset explicit limits usingset_xlim /set_ylim.

Autoscaling determines the axis limits by addingmargin times thedata interval as padding around the data. See the following illustration:

(Sourcecode,png)

All input parameters must be floats greater than -0.5. Passing bothpositional and keyword arguments is invalid and will raise a TypeError.If no arguments (positional or otherwise) are provided, the currentmargins will remain unchanged and simply be returned.

The default margins arercParams["axes.xmargin"] (default:0.05) andrcParams["axes.ymargin"] (default:0.05).

Parameters:

*marginsfloat, optional: If a single positional argument is provided, it specifiesboth margins of the x-axis and y-axis limits. If twopositional arguments are provided, they will be interpretedasxmargin,ymargin. If setting the margin on a singleaxis is desired, use the keyword arguments described below.
x, yfloat, optional: Specific margin values for the x-axis and y-axis,respectively. These cannot be used with positionalarguments, but can be used individually to alter on e.g.,only the y-axis.
tightbool or None, default: True: Thetight parameter is passed toautoscale_view,which is executed after a margin is changed; the defaulthere isTrue, on the assumption that when margins arespecified, no additional padding to match tick marks isusually desired. Settingtight toNone preservesthe previous setting.

Returns: