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

Author

Allan CORNET