Accelerating the pace of engineering and science

# Documentation Center

• Trial Software

# xlim

Set or query x-axis limits

## Syntax

xlim
xlim([xmin xmax])
xlim('mode')
xlim('auto')
xlim('manual')
xlim(axes_handle,...)

## Description

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

xlim([xmin xmax]) sets the axis limits in the current axes to the specified values.

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

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

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

xlim(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- and y-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

xlim sets or queries values of the axes object XLim, and XLimMode 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.