matplotlib.axes.Axes.margins#
- Axes.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 轴。
- 紧布尔值或 None, 默认: True
参数 tight 传递给
autoscale_view,该方法在边距更改后执行;默认值为 True,假设当指定边距时,通常不需要额外的填充来匹配刻度标记。将 tight 设置为 None 会保留之前的设置。
- 返回:
- xmargin, ymarginfloat
注释
如果之前使用的 Axes 方法如
pcolor()已将use_sticky_edges设置为True,则只会修改未被“粘性艺术家”设置的限制。要强制设置所有边距,请在调用margins()之前将use_sticky_edges设置为False。