legend
Añadir una leyenda a los ejes
Sintaxis
Descripción
legend crea una leyenda con etiquetas descriptivas para cada serie de datos representada. En las etiquetas, la leyenda usa el texto de las propiedades DisplayName de la serie de datos. Si la propiedad DisplayName está vacía, la leyenda utilizará una etiqueta con la forma 'dataN'. La leyenda se actualiza automáticamente al añadir o eliminar series de datos de los ejes. Este comando crea una leyenda en los ejes actuales, que es devuelta por el comando gca. Si los ejes actuales están vacíos, la leyenda está vacía. Si no existe ningún eje, legend crea unos ejes cartesianos.
legend( establece las etiquetas de la leyenda. Especifique las etiquetas como una lista de vectores de caracteres o cadenas, como label1,...,labelN)legend('Jan','Feb','Mar').
legend( establece las etiquetas usando un arreglo de celdas de vectores de caracteres, un arreglo de cadenas o una matriz de caracteres, como labels)legend({'Jan','Feb','Mar'}).
legend( solo incluye elementos en la leyenda para las series de datos enumeradas en subset,___)subset. Especifique subset como un vector de objetos de gráficas. Puede especificar subset antes de especificar las etiquetas o sin otros argumentos de entrada.
legend(___,'Location', establece la ubicación de la leyenda. Por ejemplo, lcn)'Location','northeast' coloca la leyenda en la esquina superior derecha de los ejes. Especifique la ubicación después de otros argumentos de entrada.
legend(___,'Orientation',, donde ornt)ornt es 'horizontal', muestra los elementos de la leyenda uno al lado de otro. El valor predeterminado de ornt es 'vertical', que apila los elementos verticalmente.
legend(___, establece las propiedades de la leyenda utilizando uno o más argumentos de par nombre-valor.Name,Value)
legend(, donde bkgd)bkgd es 'boxoff', elimina el fondo y el contorno de la leyenda. El valor predeterminado de bkgd es 'boxon', que muestra el fondo y el contorno de la leyenda.
lgd = legend(___)Legend. Use lgd para consultar y establecer las propiedades de la leyenda después de crearla. Para obtener una lista de las propiedades, consulte Legend Properties.
legend( controla la visibilidad de la leyenda, donde vsbl)vsbl es 'hide', 'show' o 'toggle'.
legend('off') elimina la leyenda.
Ejemplos
Represente dos líneas y añada una leyenda a los ejes actuales. Especifique las etiquetas de la leyenda como argumentos de entrada para la función legend.
x = linspace(0,pi); y1 = cos(x); plot(x,y1) hold on y2 = cos(2*x); plot(x,y2) legend('cos(x)','cos(2x)')
Si añade o elimina una serie de datos de los ejes, la leyenda se actualiza en consecuencia. Controle la etiqueta para la nueva serie de datos estableciendo la propiedad DisplayName como un par nombre-valor al crearla. Si no especifica una etiqueta, la leyenda usa una etiqueta con la forma 'dataN'.
Nota: Si no desea que la leyenda se actualice automáticamente cuando se añadan o se eliminen series de datos de los ejes, establezca la propiedad AutoUpdate de la leyenda en 'off'.
y3 = cos(3*x); plot(x,y3,'DisplayName','cos(3x)') hold off
Elimine la leyenda.
legend('off')
Puede mostrar un mosaico de gráficas utilizando las funciones tiledlayout y nexttile. Llame a la función tiledlayout para crear un diseño de gráfica en mosaico de 2 por 1. Llame a la función nexttile para crear los objetos de ejes ax1 y ax2. Represente datos aleatorios en cada eje. Añada una leyenda a la gráfica superior especificando ax1 como el primer argumento de entrada para legend.
tiledlayout(2,1)
y1 = rand(3);
ax1 = nexttile;
plot(y1)
y2 = rand(5);
ax2 = nexttile;
plot(y2)
legend(ax1,{'Line 1','Line 2','Line 3'})
Represente dos líneas. Especifique las etiquetas de la leyenda durante los comandos de representación estableciendo la propiedad DisplayName en el texto deseado. Después, añada una leyenda.
x = linspace(0,pi); y1 = cos(x); plot(x,y1,'DisplayName','cos(x)') hold on y2 = cos(2*x); plot(x,y2,'DisplayName','cos(2x)') hold off legend
Para excluir una línea de la leyenda, especifique su etiqueta como un vector de caracteres vacío o una cadena vacía. Por ejemplo, represente dos ondas sinusoidales y añada una línea cero discontinua llamando a la función yline. Después, cree una leyenda y excluya la línea cero especificando su etiqueta como ''.
x = 0:0.2:10; plot(x,sin(x),x,sin(x+1)); hold on yline(0,'--') legend('sin(x)','sin(x+1)','')
Represente cuatro líneas. Cree una leyenda en la parte noroeste de los ejes. Especifique el número de columnas de la leyenda utilizando la propiedad NumColumns.
x = linspace(0,pi); y1 = cos(x); plot(x,y1) hold on y2 = cos(2*x); plot(x,y2) y3 = cos(3*x); plot(x,y3) y4 = cos(4*x); plot(x,y4) hold off legend({'cos(x)','cos(2x)','cos(3x)','cos(4x)'},... 'Location','northwest','NumColumns',2)
De forma predeterminada, la leyenda ordena los elementos de arriba abajo en cada columna. Para ordenar los elementos de izquierda a derecha en cada fila, establezca la propiedad Orientation en 'horizontal'.
Desde R2023b
Puede invertir el orden de los elementos de la leyenda estableciendo la propiedad Direction de la leyenda. Por ejemplo, represente cuatro líneas y añada una leyenda.
plot([4 5 6 7; 0 1 2 3]) lgd = legend("First","Second","Third","Fourth");
Invierta el orden de los elementos de la leyenda.
lgd.Direction = "reverse";
Cuando desee compartir una leyenda entre dos o más gráficas, puede mostrar la leyenda en un mosaico separado del diseño. Puede colocar la leyenda dentro de la cuadrícula de mosaicos o en un mosaico exterior.
Cree tres gráficas en un diseño de gráfica en mosaico.
t = tiledlayout('flow','TileSpacing','compact'); nexttile plot(rand(5)) nexttile plot(rand(5)) nexttile plot(rand(5))
Añada una leyenda compartida y muévala al cuarto mosaico.
lgd = legend; lgd.Layout.Tile = 4;
Después, añada una cuarta gráfica y mueva la leyenda al mosaico este.
nexttile
plot(rand(5))
lgd.Layout.Tile = 'east';
Si no desea incluir todos los objetos de gráficas representados en la leyenda, puede especificar los objetos de gráficas que desea incluir.
Represente tres líneas y devuelva los objetos Line creados. Cree una leyenda que incluya solo dos de las líneas. Especifique el primer argumento de entrada como vector de los objetos Line que se desea incluir.
x = linspace(0,pi); y1 = cos(x); p1 = plot(x,y1); hold on y2 = cos(2*x); p2 = plot(x,y2); y3 = cos(3*x); p3 = plot(x,y3); hold off legend([p1 p3],{'First','Third'})
Cree una gráfica y añada una leyenda con marcado LaTeX llamando a la función legend y estableciendo la propiedad Interpreter en 'latex'. Rodee el marcado con símbolos de dólar ($).
x = 0:0.1:10; y = sin(x); dy = cos(x); plot(x,y,x,dy); legend('$sin(x)$','$\frac{d}{dx}sin(x)$','Interpreter','latex');
Represente dos líneas y cree una leyenda. Después, añada un título a la leyenda.
x = linspace(0,pi); y1 = cos(x); plot(x,y1) hold on y2 = cos(2*x); plot(x,y2) hold off lgd = legend('cos(x)','cos(2x)'); title(lgd,'My Legend Title')
Represente dos líneas y cree una leyenda en la esquina inferior izquierda de los ejes. Después, elimine el fondo y el contorno de la leyenda.
x = linspace(0,pi); y1 = cos(x); plot(x,y1) hold on y2 = cos(2*x); plot(x,y2) hold off legend({'cos(x)','cos(2x)'},'Location','southwest') legend('boxoff')
Puede cambiar distintos aspectos de una leyenda estableciendo propiedades. Puede establecer estas propiedades especificando argumentos nombre-valor cuando llame a legend, o puede establecer las propiedades del objeto Legend después de llamar a legend.
Represente cuatro líneas de datos aleatorios. Cree una leyenda y asigne el objeto Legend a la variable lgd. Establezca las propiedades FontSize y TextColor usando argumentos nombre-valor.
rdm = rand(4);
plot(rdm)
lgd = legend({'Line 1','Line 2','Line 3','Line 4'},...
'FontSize',12,'TextColor','blue');
Modifique la leyenda después de crearla refiriéndose al valor lgd. Establezca la propiedad NumColumns utilizando la notación objeto-punto-nombre de propiedad.
lgd.NumColumns = 2;
Desde R2024b
Puede especificar las anchuras de los iconos de las leyendas estableciendo la propiedad IconColumnWidth. Por ejemplo, represente una línea y dos conjuntos de datos dispersos.
% Create the data x = 1:50; sample1 = x + randn(1,50); sample2 = (x-5) + randn(1,50); y = x - 10; % Plot the data plot(x,y) hold on scatter(x,sample1,"filled") scatter(x,sample2,"filled") hold off
Añada una leyenda horizontal a la parte superior de la gráfica. El icono de la línea es más ancho que los iconos de los dos marcadores, de modo que la leyenda contiene algo más de blanco alrededor de los iconos de los marcadores.
lgd = legend("Expected","Sample 1","Sample 2"); lgd.Location = "north"; lgd.Orientation = "horizontal";
Reduzca el ancho de la columna de los iconos estableciendo la propiedad IconColumnWidth en 10. Como resultado, el icono de la línea se acorta y el espacio alrededor de los marcadores se reduce.
lgd.IconColumnWidth = 10;
Argumentos de entrada
Argumentos de par nombre-valor
Especifique pares opcionales de argumentos como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos nombre-valor deben aparecer después de otros argumentos, pero el orden de los pares no importa.
En las versiones anteriores a R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas.
Ejemplo: legend({'A','B'},'TextColor','blue','FontSize',12) crea una leyenda con fuente azul de 12 puntos.
Nota
Las propiedades que se enumeran aquí son solo un subconjunto. Para obtener una lista completa, consulte Legend Properties.
Color del texto, especificado como triplete RGB, código de color hexadecimal, nombre de color o nombre corto. El color predeterminado es negro con un valor de [0 0 0].
Para definir un color personalizado, especifique un triplete RGB o un código de color hexadecimal.
Un triplete RGB es un vector fila de tres elementos, cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades deben estar en el rango
[0,1], por ejemplo[0.4 0.6 0.7].Un código de color hexadecimal es un escalar de cadena o un vector de caracteres que comienza con el símbolo de almohadilla (
#) seguido de tres o seis dígitos hexadecimales, que pueden oscilar entre0yF. Los valores no distinguen entre mayúsculas y minúsculas. Por lo tanto, los códigos de color"#FF8800","#ff8800","#F80"y"#f80"son equivalentes.
Como alternativa, puede especificar algunos colores frecuentes por su nombre. En esta tabla, se enumeran las opciones de color con su nombre, los tripletes RGB equivalentes y los códigos de color hexadecimales.
| Nombre del color | Nombre corto | Triplete RGB | Código de color hexadecimal | Apariencia |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
"none" | No se aplica | No se aplica | No se aplica | Sin color |
En esta tabla, se enumeran las paletas de colores predeterminados para las gráficas en los temas claro y oscuro.
| Paleta | Colores de la paleta |
|---|---|
Antes de R2025a: La mayoría de las gráficas utilizan estos colores de forma predeterminada. |
|
|
|
Puede obtener los tripletes RGB y los códigos de color hexadecimales de estas paletas usando las funciones orderedcolors y rgb2hex. Por ejemplo, puede obtener los tripletes RGB de la paleta "gem" y convertirlos en códigos de color hexadecimales.
RGB = orderedcolors("gem");
H = rgb2hex(RGB);Antes de R2023b: Obtenga los tripletes RGB usando RGB = get(groot,"FactoryAxesColorOrder").
Antes de R2024a: Obtenga los códigos de color hexadecimales usando H = compose("#%02X%02X%02X",round(RGB*255)).
Ejemplo: [0 0 1]
Ejemplo: 'blue'
Ejemplo: '#0000FF'
Argumentos de salida
Sugerencias
Para etiquetar más de 50 objetos en la leyenda, especifique una etiqueta para cada uno. De lo contrario,
legendrepresenta solo los primeros 50 objetos de la gráfica.
Algoritmos
Recuperando la función
legendno se restablecen las propiedades de leyenda, como la ubicación o la orientación. Si existe una leyenda, la funciónlegendactualiza la leyenda existente. Un objetoAxespuede tener solo una leyenda.La leyenda refleja la visibilidad de los objetos de gráficas en los ejes. Los objetos de gráficas que tienen una propiedad
Visibleestablecida en'off'aparecen como elementos destacados en color gris en la leyenda.
Historial de versiones
Introducido antes de R2006aEl orden predeterminado de los elementos de la leyenda de las gráficas de barras apiladas (verticales) y las gráficas de área ahora se invierte para que coincida con el orden de apilamiento de la gráfica. Anteriormente, los elementos de la leyenda aparecían en el orden inverso al de las gráficas de barras apiladas y de área.
Para conservar el orden de las versiones anteriores, establezca la propiedad Direction de la leyenda en "normal".
Cuando llama a la función legend y especifica una etiqueta como vector de caracteres vacío, cadena vacía o elemento vacío en un arreglo de celdas o arreglo de cadenas, la entrada correspondiente se omite de la leyenda. En la versión R2020b y versiones anteriores, la entrada aparece en la leyenda sin etiqueta.
Por ejemplo, este código representa dos ondas sinusoidales y una línea de referencia en y=0. Después, crea una leyenda con tres etiquetas, donde la última etiqueta está vacía. En la versión R2020b, la tercera línea aparece en la leyenda sin etiqueta. En la versión R2021a, la tercera línea se omite de la leyenda.
x = 0:0.2:10; plot(x,sin(x),x,sin(x+1)); hold on yline(0,'--') legend('sin(x)','sin(x+1)','')
Para mantener una entrada en la leyenda sin etiqueta, incluya un carácter de espacio en la etiqueta. Por ejemplo, para actualizar el código anterior, especifique la última etiqueta como un vector de caracteres que contiene un espacio (' ').
legend('sin(x)','sin(x+1)',' ')
De forma alternativa, si no desea mostrar un carácter de espacio, puede pasar los objetos de línea individuales a la función legend con un arreglo de etiquetas. Para obtener los objetos de línea individuales, llame a cada función de representación con un argumento de salida.
x = 0:0.2:10; p = plot(x,sin(x),x,sin(x+1)); hold on line0 = yline(0,'--'); legend([p(1) p(2) line0], {'sin(x)','sin(x+1)',''});
