matplotlib.pyplot.margins

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

设置或检索数据周围的边距，用于自动缩放轴限制。

这允许在不使用 set_xlim / set_ylim 设置显式限制的情况下配置数据周围的填充。

自动缩放通过添加数据区间乘以边距作为数据周围的填充来确定轴限。参见以下图示：

(源代码, 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，这是基于当指定边距时，通常不需要额外的填充来匹配刻度线的假设。将tight设置为 None 将保留之前的设置。

返回:

xmargin, ymarginfloat

另请参阅

Axes.set_xmargin, Axes.set_ymargin

备注

注意

这是 pyplot 封装，用于 axes.Axes.margins。

如果之前使用的 Axes 方法，例如 pcolor()，已将 use_sticky_edges 设置为 True，则只有未由“粘性艺术家”设置的限制会被修改。要强制设置所有边距，请在调用 margins() 之前将 use_sticky_edges 设置为 False。

使用 matplotlib.pyplot.margins 的示例

使用边距和粘性边缘控制视图限制

使用边距和粘性边缘控制视图限制