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

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

标记参考

Marker reference

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

Timeline with lines, dates, and text

Trigradient 演示

Trigradient Demo

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

Controlling view limits using margins and sticky_edges

尺度不变角度标签

Scale invariant angle label

ggplot 样式表

ggplot style sheet

自动缩放轴

Autoscaling Axis