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]#

Set the 3D z-axis view limits.

Parameters:

bottomfloat, optional

The bottom zlim in data coordinates. PassingNone leaves thelimit unchanged.

The bottom and top zlims may also be passed as the tuple(bottom,top) as the first positional argument (or asthebottom keyword argument).

topfloat, optional

The top zlim in data coordinates. PassingNone leaves thelimit unchanged.

emitbool, default: True

Whether to notify observers of limit change.

autobool or None, default: False

Whether to turn on autoscaling of the z-axis.True turns on,False turns off,None leaves unchanged.

view_marginfloat, optional

The additional margin to apply to the limits.

zmin, zmaxfloat, optional

They are equivalent to bottom and top respectively, and it is anerror to pass bothzmin andbottom orzmax andtop.

Returns:

bottom, top(float, float): The new z-axis limits in data coordinates.

See also

get_zlim
set_zbound,get_zbound
invert_zaxis,zaxis_inverted

Notes

Thebottom value may be greater than thetop value, in whichcase the z-axis values will decrease frombottom totop.

Examples

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

One limit may be left unchanged.

>>>set_zlim(top=top_lim)

Limits may be passed in reverse order to flip the direction ofthe z-axis. For example, supposez represents depth of theocean in m. The z-axis limits might be set like the followingso 5000 m depth is at the bottom of the plot and the surface,0 m, is at the top.