mpl_toolkits.mplot3d.axes3d.Axes3D.set_zlim#

Axes3D.set_zlim(bottom=None, top=None, *, emit=True, auto=False, view_margin=None, zmin=None, zmax=None)[source]#

设置 3D z 轴的视图范围。

参数:

bottomfloat, optional

数据坐标系下的 z 轴下限。传入 None 则保持范围不变。

z 轴的下限和上限也可以作为第一个位置参数（或作为 bottom 关键字参数）以元组 (bottom, top) 的形式传入。

topfloat, optional

数据坐标系下的 z 轴上限。传入 None 则保持范围不变。

emitbool, 默认值: True

是否通知观察者限制已更改。

autobool 或 None, 默认值: False

是否开启 z 轴的自动缩放。True 表示开启，False 表示关闭，None 表示保持不变。

view_margin浮点数，可选

应用于限制的额外边距。

zmin, zmaxfloat, optional

它们分别等价于 bottom 和 top。同时传入 zmin 和 bottom 或者 zmax 和 top 是错误的。

返回:

另请参阅

备注

bottom 的值可以大于 top 的值，这种情况下，z 轴的值将从 bottom 向 top 减小。

示例

>>> set_zlim(bottom, top)
>>> set_zlim((bottom, top))
>>> bottom, top = set_zlim(bottom, top)

其中一个限制可以保持不变。

>>> set_zlim(top=top_lim)

范围可以反向传入以翻转 z 轴的方向。例如，假设 z 代表海深（单位：米）。可以按照如下方式设置 z 轴范围，使 5000 米的深度位于绘图底部，而海平面（0 米）位于顶部。

>>> set_zlim(5000, 0)

使用 `mpl_toolkits.mplot3d.axes3d.Axes3D.set_zlim` 的示例#