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

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