Accelerating the pace of engineering and science

# Documentation Center

• Trial Software

# zlim

Set or query z-axis limits

## Syntax

zlim
zlim([zmin zmax])
zlim('mode')
zlim('auto')
zlim('manual')
zlim(axes_handle,...)

## Description

zlim with no arguments returns the limits of the current axes.

zlim([zmin zmax]) sets the axis limits in the current axes to the specified values.

zlim('mode') returns the current value of the axis limits mode, which can be either auto (the default) or manual.

zlim('auto') sets the axis limit mode to auto.

zlim('manual') sets the axis limit mode to manual.

zlim(axes_handle,...) performs the set or query on the axes identified by the first argument, axes_handle. When you do not specify an axes handle, it operates on the current axes.

## Examples

This example illustrates how to set the x-, y-, and z-axis limits to match the actual range of the data, rather than the rounded values of[-2 3] for the x-axis ,[-2 4] for the y-axis and [-0.5 0.5] for z-axis originally selected by MATLAB®.

```[x,y] = meshgrid([-1.75:.2:3.25]);
z = x.*exp(-x.^2-y.^2);
surf(x,y,z)
xlim([-1.75 3.25])
ylim([-1.75 3.25])
zlim([-0.45 0.45])```

## Alternatives

To control the upper and lower axis limits on a graph, use the Property Editor, one of the plotting tools . For details, see The Property Editor.

expand all

### Tips

zlim sets or queries values of the axes object ZLim and ZLimMode property.

When the axis limit mode is set to auto (the default), MATLAB uses limits, which are round numbers, to span the range of the data being displayed. Setting a value for any of the limits also sets the corresponding mode to manual. If you set the limits on an existing graph and want to maintain these limits while adding more graphs, use the hold command.

 Note:   High-level plotting functions like plot and surf reset both the modes and the limits.