matplotlib.axes.Axes.margins#

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

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

这允许配置数据周围的填充,而无需使用 set_xlim / set_ylim 设置明确的限制。

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

(源代码, 2x.png, png)

所有输入参数都必须是大于 -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

使用 matplotlib.axes.Axes.margins 的示例#

三角梯度演示

三角梯度演示

标记参考

标记参考

带线条、日期和文本的时间线

带线条、日期和文本的时间线

ggplot 样式表

ggplot 样式表

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

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

比例不变角度标签

比例不变角度标签

自动缩放坐标轴

自动缩放坐标轴