CLIM Adjust Color limits of plot

Section: Handle-Based Graphics

Usage

There are several ways to use clim to adjust the color limits of a plot. The various syntaxes are
   clim
   clim([lo,hi])   
   clim('auto')
   clim('manual')
   clim('mode')
   clim(handle,...)

The first form (without arguments), returns a 2-vector containing the current limits. The second form sets the limits on the plot to [lo,hi]. The third and fourth form set the mode for the limit to auto and manual respectively. In auto mode, FreeMat chooses the range for the axis automatically. The clim('mode') form returns the current mode for the axis (either 'auto' or 'manual'). Switching to manual mode does not change the limits, it simply allows you to modify them (and disables the automatic adjustment of the limits as more objects are added to the plot). Also, if you specify a set of limits explicitly, the mode is set to manual Finally, you can specify the handle of an axis to manipulate instead of using the current one.

Example

Here is an example of using clim to change the effective window and level onto an image. First, the image with default limits
--> x = repmat(linspace(-1,1),[100,1]); y = x';
--> z = exp(-x.^2-y.^2);
--> image(z);
--> min(z(:))

ans = 
    0.1353 

--> max(z(:))

ans = 
    0.9998 

which results in

Next, we change the colorscale of the image using the clim function

--> image(z);
--> clim([0,0.2]);

which results in