matplotlib.axes.Axes.margins#
- Axes.margins(*margins, x=None, y=None, tight=True)[源代码]#
设置或检索数据周围的边距,用于自动缩放轴限制。
这允许配置数据周围的填充,而无需使用
set_xlim
/set_ylim
设置明确的限制。自动缩放通过添加 margin 乘以数据区间作为数据周围的填充来确定轴限制。参见下图
所有输入参数都必须是大于 -0.5 的浮点数。同时传递位置参数和关键字参数是无效的,将引发 TypeError。如果未提供任何参数(位置参数或其他),则当前边距将保持不变并直接返回。
默认边距为
rcParams["axes.xmargin"]
(默认值:0.05
)和rcParams["axes.ymargin"]
(默认值:0.05
)。- 参数:
- *margins浮点型, 可选
如果提供一个位置参数,它指定了 x 轴和 y 轴限制的两个边距。如果提供两个位置参数,它们将被解释为 xmargin, ymargin。如果需要设置单个轴的边距,请使用下面描述的关键字参数。
- x, y浮点型, 可选
分别用于 x 轴和 y 轴的特定边距值。这些不能与位置参数一起使用,但可以单独使用以改变,例如,仅改变 y 轴。
- tight布尔型或 None, 默认值: True
tight 参数被传递给
autoscale_view
,它在边距更改后执行;这里的默认值是 True,假设在指定边距时,通常不需要额外的填充来匹配刻度线。将 tight 设置为 None 会保留之前的设置。
- 返回:
- xmargin, ymargin浮点型
备注
如果之前使用的 Axes 方法,例如
pcolor()
已将use_sticky_edges
设置为True
,则只修改未由“粘性艺术家”设置的限制。要强制设置所有边距,请在调用margins()
之前将use_sticky_edges
设置为False
。