a legend: of every artist a displayName named, or naming the curves of the current axes

Syntax

legend()

A legend of every displayName of the figure.

legend('first', 'second')

Names the curves in the order they were drawn.

legend(location='southwest', numColumns=2)

Another place, two columns.

legend(location='northoutside')

Beside the charts, outside the axes.

legend('off')

Removes the legends.

Description

Without names the legend collects every artist of the figure that a displayName (a label) named, each name once, as MATLAB’s legend(‘show’). With names it names the bars, curves and markers of the current axes in the order they were drawn, as MATLAB’s legend with labels.

A new legend replaces those the figure has. It goes into the last axes of the figure, or, for a location ending in ‘outside’, beside the charts, the figure widened when it would not fit. Every entry gets a marker of the same size. Other keywords go to matplotlib’s legend.

Input

names str, the names of the curves; ‘off’ removes the legends

Keywords

keyword	default	description
`location`	`'northeast'`	MATLAB’s compass names, ‘north’, ‘northeast’, …, ‘best’, or with ‘outside’ appended to place it beside the charts
`numColumns`	`1`	the number of columns of the legend
`fontSize`	`None`	the font size; by default the preference FontSize

Output

leg the matplotlib legend, None for ‘off’

Used on

OrientationFibre, OrientationStandard, WaveVelocities, BoundaryPlots, GrainSmoothing, AngleDistributionFunction, MisorientationDistributionFunction, MisorientationGrainExchangeSym, MisorientationTheory, SlipTransmission, Annotations, CombinedPlots

source

Citing this page. This page is part of the documentation of MTEX, a free and open source MATLAB toolbox for analyzing and modeling crystallographic textures. It was written by The MTEX Developers and is published at https://mtex-toolbox.github.io/legend_py.html. If you use MTEX, or reuse text or figures from this page, in your research, please cite

F. Bachmann, R. Hielscher, H. Schaeben: Texture Analysis with MTEX - Free and Open Source Software Toolbox, Solid State Phenomena 160 (2010), 63-68. 10.4028/www.scientific.net/SSP.160.63

BibTeX

@article{bachmann2010mtex,
  author  = {F. Bachmann and R. Hielscher and H. Schaeben},
  title   = {Texture Analysis with MTEX - Free and Open Source Software Toolbox},
  journal = {Solid State Phenomena},
  volume  = {160},
  pages   = {63-68},
  year    = {2010},
  doi     = {10.4028/www.scientific.net/SSP.160.63},
  url     = {https://doi.org/10.4028/www.scientific.net/SSP.160.63}
}

Other papers describing specific MTEX methods are listed under Publications — please cite the one that best fits your application. The MTEX source code is licensed under the GNU General Public License v2.0; the text and figures of this documentation are licensed under CC BY 4.0, which permits reuse — including by automated systems — provided The MTEX Developers and this page are credited.

legend