# Documentation of clabel

Global Index (all files) (short | long) | Local Index (files in subdir) (short | long)

## Function Synopsis

    hh = clabel(cs,varargin)

## Help text

    CLABEL Contour plot elevation labels.
       CLABEL(CS,H) adds height labels to the current contour
       plot.  The labels are rotated and inserted within the contour
       lines.  CS and H are the contour matrix output and object handle
       outputs from CONTOUR, CONTOUR3, or CONTOURF.

       CLABEL(CS,H,V) labels just those contour levels given in
       vector V.  The default action is to label all known contours.
       The label positions are selected randomly.

       CLABEL(CS,H,'manual') places contour labels at the locations
       clicked on with a mouse.  Pressing the return key terminates
       labeling.  Use the space bar to enter contours and the arrow
       keys to move the crosshair if no mouse is available.

       CLABEL(CS) or CLABEL(CS,V) or CLABEL(CS,'manual') places
       contour labels as above, except that the labels are drawn as
       plus signs on the contour with a nearby height value.

       H = CLABEL(...) returns handles to the TEXT (and possibly LINE)
       objects created.  The UserData property of the TEXT objects contain
       the height value for each label.

       Text property/value pairs can be appended to the list of
       input arguments in the above:
       CLABEL(clabel options, 'text property', property_value , ... )

       One special property ('label') is also available to specify
       the spacing between labels (in points). This defaults to 144, or
       2 inches.

       Example
          subplot(1,3,1), [cs,h] = contour(peaks); clabel(cs,h,'label',72)
          subplot(1,3,2), cs = contour(peaks); clabel(cs)
          subplot(1,3,3), [cs,h] = contour(peaks);
           clabel(cs,h,'fontsize',15,'color','r','rotation',0)

       See also CONTOUR, CONTOUR3, CONTOURF, LINELABEL.

## Cross-Reference Information

| This function is called by
--- | ---
| m_demo

Pierre-Michel THEVENY <theveny@dt.insu.cnrs.fr>