Documentation

This is machine translation

Translated by Microsoft
Mouse over text to see original. Click the button below to return to the English verison of the page.

라이선스가 부여된 사용자만 번역 문서를 볼 수 있습니다. 번역 문서를 보려면 로그인하십시오.

zlim

Set or query z-axis limits

Syntax

  • zlim auto
  • zlim manual
  • zl = zlim
  • m = zlim('mode')
  • ___ = zlim(ax,___)

Description

example

zlim(limits) sets the z-axis limits for the current axes. Specify limits as a two-element vector of the form [zmin zmax], where zmax is greater than zmin.

zlim auto lets the axes choose the z-axis limits. The axes chooses limits that span the range of the plotted data. This command sets the ZLimMode property for the axes to 'auto'..

zlim manual freezes the limits at the current values. Use this option if you want to retain the current limits when adding new data to the axes using the hold on command. This command sets the ZLimMode property for the axes to 'manual'.

zl = zlim returns a two-element vector containing the current limits.

m = zlim('mode') returns the current value of the limits mode, which is either 'auto' or 'manual'. By default, the mode is automatic unless you specify limits or set the mode to manual.

___ = zlim(ax,___) uses the axes specified by ax instead of the current axes. The ax input argument can precede any of the input arguments in the previous syntaxes. Use single quotes around input arguments that are character vectors, for example, zlim(ax,'auto') and zlim(ax,'manual'). You can include any of the output arguments in the preceding syntaxes if the original syntax supports an output argument.

Examples

collapse all

Plot a surface and set the z-axis limits to range from -5 to 5.

[X,Y,Z] = peaks;
surf(X,Y,Z);
zlim([-5 5])

Create a figure with two subplots and plot the same data in each subplot. Set the z-axis limits for the bottom subplot.

[X,Y,Z] = peaks;
ax1 = subplot(2,1,1);
surf(X,Y,Z)

ax2 = subplot(2,1,2);
surf(X,Y,Z)
zlim(ax2,[-5 5])

Use manual mode to maintain the current z-axis limits when you add more plots to the axes.

First, create a 3-D scatter plot.

theta = linspace(0,2*pi);
X = cos(theta);
Y = sin(theta);
Z = theta;
scatter3(X,Y,Z)

Set the z-axis limits mode to manual so that the limits to not change. Use hold on to add a second plot to the axes.

zlim manual
hold on
Znew = 5*theta;
scatter3(X,Y,Znew)
hold off

The z-axis limits do not update to incorporate the new plot.

Switch back to automatically updated limits by setting the mode to automatic.

zlim auto

Create a 3-D scatter plot of random data. Return the values of the z-axis limits.

x = randn(50,1);
y = randn(50,1);
z = randn(50,1);
scatter3(x,y,z)

zl = zlim
zl =

    -3     3

Input Arguments

collapse all

Minimum and maximum limits, specified as a two-element vector of the form [zmin zmax], where zmax isgreater than zmin. You can specify the limits as numeric, datetime, or duration values. However, the type of values that you specify must match the type of values along the z-axis.

You can specify both limits, or specify one limit and let MATLAB® automatically calculate the other.

  • To automatically set the minimum limit to the minimum data value, specify the first element as -inf, for example, zlim([-inf 0]).

  • To automatically set the maximum limit to the maximum data value, specify the second element as inf, for example, zlim([0 inf]).

When you specify the limits, the ZLim property for the axes object changes to the specified values, and the ZLimMode property changes to 'manual'. Specifying the z-axis limits can cause other limits to change, unless their corresponding modes are manual.

Example: [0 1]

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | datetime | duration

Axes object. If you do not specify an axes object, then zlim sets the limits for the current axes (gca).

Output Arguments

collapse all

Current limits, returned as a two-element vector of the form [zmin zmax].

Querying the limits returns the ZLim property value for the corresponding axes.

Current limits mode, returned as one of these values:

  • 'auto' — The limits update to reflect changes in the data.

  • 'manual' — The limits do not update to reflect changes in the data.

Querying the z-axis limits mode returns ZLimMode property value for the corresponding axes.

Introduced before R2006a

Was this topic helpful?