caxis
Set colormap limits
Description
caxis( sets the colormap
limits for the current axes. limits)limits is a two-element vector
of the form [cmin cmax]. All values in the colormap indexing array that are less
than or equal to cmin map to the first row in the colormap.
All values that are greater than or equal to cmax map to the
last row in the colormap. All values between cmin and
cmax map linearly to the intermediate rows of the colormap.
Note
The caxis function only affects graphics objects
that have the CDataMapping property set to
'scaled'. It does not affect graphics objects
that use truecolor or have the CDataMapping set to
'direct'.
caxis('auto') enables automatic limit updates when values
in the colormap indexing array change. This is the default behavior. The
caxis auto command is an alternative form of this
syntax.
caxis('manual') disables automatic limit updates. The
caxis manual command is an alternative form of this
syntax.
Examples
Raise the Lower Limit
Plot a paraboloid with a colorbar.
[X,Y] = meshgrid(-5:.5:5); Z = X.^2 + Y.^2; surf(Z); colorbar
Get the current color limits.
lim = caxis
lim = 1×2
0 50
Raise the lower limit to 20. Notice that all values of Z that are less than or equal to 20 map to the first color.
caxis([20 50])
Hold Color Limits for Multiple Surface Plots
Create two paraboloid surfaces that are vertically offset.
[X,Y] = meshgrid(-5:.5:5); Z1 = X.^2 + Y.^2; Z2 = Z1 + 50;
Plot the first paraboloid. Add a colorbar, and hold the axes for the second paraboloid.
surf(X,Y,Z1);
colorbar
hold on
Hold the current color limits using the 'manual' option. Then plot the second paraboloid.
caxis('manual');
surf(X,Y,Z2);
Set Color Limits on a Specific Axes
Starting in R2019b, you can display a tiling of plots using the tiledlayout and nexttile functions. Call the tiledlayout function to create a 1-by-2 tiled chart layout. Call the nexttile function to create the axes objects ax1 and ax2. Plot a paraboloid into each axes.
[X,Y] = meshgrid(-5:1:5); Z = X.^2 + Y.^2; tiledlayout(1,2) % Left plot ax1 = nexttile; surf(ax1,Z); % Right plot ax2 = nexttile; surf(ax2,Z);
Raise the lower color limit of the right axes to 20.
caxis(ax2,[20 50])
