matplotlib.pyplot.margins#

matplotlib.pyplot.margins(*margins, x=None, y=None, tight=True)[源代码][源代码]#

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

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

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

所有输入参数必须是大于 -0.5 的浮点数。同时传递位置参数和关键字参数是无效的，并且会引发 TypeError。如果没有提供任何参数（位置参数或其他），当前的边距将保持不变并简单地返回。

默认的边距是 rcParams["axes.xmargin"] (default: 0.05) 和 rcParams["axes.ymargin"] (default: 0.05)。

参数:

*边距浮点数，可选: 如果提供了一个位置参数，它将同时指定 x 轴和 y 轴的边界。如果提供了两个位置参数，它们将被解释为 xmargin 和 ymargin。如果希望仅设置单个轴的边界，请使用下面描述的关键字参数。
x, y浮点数，可选: 分别指定 x 轴和 y 轴的特定边距值。这些不能与位置参数一起使用，但可以单独使用以例如仅更改 y 轴。
紧密布尔值或无, 默认: True: 参数 tight 传递给 autoscale_view，该操作在边距更改后执行；默认值为 True，假设当指定边距时，通常不需要额外的填充来匹配刻度标记。将 tight 设置为 None 将保留之前的设置。

返回: