legend

Add legend to axes.

Syntax

• legend()

• legend(label1, ..., labelN)

• legend(labels)

• legend('off')

• legend('hide')

• legend('show')

• legend('toggle')

• legend('boxon')

• legend('boxoff')

• legend(ax, ...)

• legend(..., 'Location', lcn)

• legend(..., propertyName, propertyValue)

• L = legend(...)

Input argument

• label1, ..., labelN - sets the legend labels: row vector characters.

• labels - cell array of character vectors or string array.

• 'off' - delete the legend.

• 'toggle' - toggle legend visibility.

• 'hide' - hide legend.

• 'show' - show legend.

• 'boxon' - display box around legend.

• 'boxoff' - hide box around legend.

• ax - axes to make current.

• lcn - Legend location: a string ('NE' default).

• propertyName - a scalar string or row vector character.

• propertyValue - a value.

Output argument

• L - a graphics object: axes type.

Description

legend creates a legend in the current figure.

Location for legend on the plot:

'northeast' or 'NE': Top right (default).

'north' or 'N': Top center.

'south' or 'S': Bottom center.

'east' or 'E': Middle right.

'west' or 'W': Middle left.

'northwest' or 'NW': Top left.

'southeast' or 'SE': Bottom right.

'southwest' or 'SW': Bottom left.

Example

f = figure();
x = linspace(0,10);
y1 = sin(x);
y2 = cos(x);
ax = gca();
plot(ax, x, y1);
plot(ax, x, y2);
legend('sin(x)', 'cos(x)', 'Location', 'N')

See also

title, text, plot.

History

Version	Description
1.0.0	initial version

Author

Allan CORNET