Home > freetb4matlab > plot > clabel.m

clabel

PURPOSE ^

% Adds labels to the contours of a contour plot. The contour plot is specified

SYNOPSIS ^

function retval = clabel (c, varargin)

DESCRIPTION ^

% -*- texinfo -*-
% @deftypefn {Function File} {} clabel (@var{c}, @var{h})
% @deftypefnx {Function File} {} clabel (@var{c}, @var{h}, @var{v})
% @deftypefnx {Function File} {} clabel (@var{c}, @var{h}, 'manual')
% @deftypefnx {Function File} {} clabel (@var{c})
% @deftypefnx {Function File} {} clabel (@var{c}, @var{h})
% @deftypefnx {Function File} {} clabel (@dots{}, @var{prop}, @var{val}, @dots{})
% @deftypefnx {Function File} {@var{h} =} clabel (@dots{})
% Adds labels to the contours of a contour plot.  The contour plot is specified
% by the contour matrix @var{c} and optionally the contourgroup object @var{h}
% that are returned by @code{contour}, @code{contourf} and @code{contour3}.
% The contour labels are rotated and placed in the contour itself.
%
% By default, all contours are labelled.  However, the contours to label can be
% specified by the vector @var{v}.  If the 'manual' argument is given then
% the contours to label can be selected with the mouse.
%
% Additional property/value pairs that are valid properties of text objects
% can be given and are passed to the underlying text objects.  Additionally,
% the property 'LabelSpacing' is available allowing the spacing between labels
% on a contour (in points) to be specified.  The default is 144 points, or 2
% inches.
%
% The returned value @var{h} is the set of text object that represent the
% contour labels.  The 'userdata' property of the text objects contains the
% numerical value of the contour label.
%
% An example of the use of @code{clabel} is
%
% @example
% @group
% [c, h] = contour (peaks, -4 : 6);
% clabel (c, h, -4 : 2 : 6, 'fontsize', 12);
% @end group
% @end example
%
% @seealso{contour, contourf, contour3, meshc, surfc, text}
% @end deftypefn

CROSS-REFERENCE INFORMATION ^

This function calls: This function is called by:
Generated on Fri 22-May-2009 15:13:00 by m2html © 2003