MATLAB Function Reference    
xlim, ylim, zlim

Set or query axis limits


Note that the syntax for each of these three functions is the same; only the xlim function is used for simplicity. Each operates on the respective x-, y-, or z-axis.


xlim with no arguments returns the respective 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 respective 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, these functions operate on the current axes.


xlim, ylim, and zlim set or query values of the axes object XLim, YLim, ZLim, and XLimMode, YLimMode, ZLimMode properties.

When the axis limit modes are auto (the default), MATLAB uses limits that span the range of the data being displayed and are round numbers. Setting a value for any of the limits also sets the corresponding mode to manual. Note that high-level plotting functions like plot and surf reset both the modes and the limits. If you set the limits on an existing graph and want to maintain these limits while adding more graphs, use the hold command.


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 and [-2 4] for the y-axis originally selected by MATLAB.

See Also


The axes properties XLim, YLim, ZLim

Setting the Aspect Ratio and Axis Limits for related functions

Understanding Axes Aspect Ratio for more information on how axis limits affect the axes.

  xlabel, ylabel, zlabel xlsfinfo