MATLAB Function Reference Previous page   Next Page
xlabel, ylabel, zlabel

Label the x-, y-, and z-axis

Syntax

Description

Each axes graphics object can have one label for the x-, y-, and z-axis. The label appears beneath its respective axis in a two-dimensional plot and to the side or beneath the axis in a three-dimensional plot.

xlabel('string') labels the x-axis of the current axes.

xlabel(fname) evaluates the function fname, which must return a string, then displays the string beside the x-axis.

xlabel(...,'PropertyName',PropertyValue,...) specifies property name and property value pairs for the text graphics object created by xlabel.

xlabel(axes_handle,...), ylabel(axes_handle,...), and zlabel(axes_handle,...) plot into the axes with handle axes_handle instead of the current axes (gca).

h = xlabel(...), h = ylabel(...), and h = zlabel(...) return the handle to the text object used as the label.

ylabel(...) and zlabel(...) label the y-axis and z-axis, respectively, of the current axes.

Remarks

Reissuing an xlabel, ylabel, or zlabel command causes the new label to replace the old label.

For three-dimensional graphics, MATLAB puts the label in the front or side, so that it is never hidden by the plot.

Examples

Create a multiline label for the x-axis using a multiline cell array.

See Also

text, title

Annotating Plots for related functions

Adding Axis Labels to Graphs for more information about labeling axes


Previous page  workspace xlim, ylim, zlim Next page

© 1994-2005 The MathWorks, Inc.