MATLAB Function Reference |
Syntax
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.
Description
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.
Remarks
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.
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 and [-2 4]
for the y-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])
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 |
© 1994-2005 The MathWorks, Inc.