legend
Ajouter une légende aux axes
Syntaxe
Description
legend crée une légende avec des étiquettes descriptives pour chaque série de données tracée. Pour les étiquettes, la légende utilise le texte indiqué dans les propriétés DisplayName de la série de données. Si la propriété DisplayName est vide, la légende utilise une étiquette de la forme 'dataN'. La légende se met automatiquement à jour lorsque vous ajoutez ou supprimez une série de données sur les axes. Cette commande crée une légende dans les axes courants qui sont renvoyés par la commande gca. Si les axes courants sont vides, la légende l’est aussi. Si les axes n’existent pas, legend crée des axes cartésiens.
legend(label1,...,labelN) définit les étiquettes de la légende. Spécifiez les étiquettes sous forme de liste de vecteurs de caractères ou de chaînes de caractères, par exemple legend('Jan','Feb','Mar').
legend( définit les étiquettes avec un cell array de vecteurs de caractères, un tableau de chaînes de caractères ou une matrice de caractères, par exemple labels)legend({'Jan','Feb','Mar'}).
legend( inclut uniquement des éléments dans la légende pour la série de données indiquée dans subset,___)subset. Spécifiez subset sous forme de vecteur d’objets graphiques. Vous pouvez spécifier subset avant de spécifier les étiquettes ou sans autre argument en entrée.
legend(___,'Location', définit l’emplacement de la légende. Par exemple, lcn)'Location','northeast' la positionne dans le coin supérieur droit des axes. Spécifiez l’emplacement après les autres arguments en entrée.
legend(___,'Orientation',, où ornt)ornt est 'horizontal', affiche les éléments de la légende côte à côte. La valeur par défaut de ornt est 'vertical', qui empile verticalement les éléments.
legend(___, définit les propriétés de la légende avec un ou plusieurs arguments de type paire nom-valeur.Name,Value)
legend(, où bkgd)bkgd est 'boxoff', supprime l’arrière-plan et le contour de la légende. La valeur par défaut de bkgd est 'boxon', qui affiche l’arrière-plan et le contour de la légende.
lgd = legend(___)Legend. Utilisez lgd pour interroger et définir les propriétés de la légende après sa création. Consultez Legend Properties pour obtenir une liste des propriétés.
legend( contrôle la visibilité de la légende. vsbl)vsbl peut être défini sur 'hide', 'show' ou 'toggle'.
legend('off') supprime la légende.
Exemples
Tracez deux lignes et ajoutez une légende aux axes courants. Spécifiez les étiquettes de la légende en tant qu’arguments en entrée de la fonction 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 vous ajoutez ou supprimez une série de données sur les axes, la légende se met à jour en conséquence. Contrôlez l’étiquette de la nouvelle série de données en définissant la propriété DisplayName en tant que paire nom-valeur au moment de la création. Si vous ne spécifiez pas d’étiquette, la légende en utilise une de la forme 'dataN'.
Remarque : si vous ne voulez pas que la légende se mette à jour automatiquement lorsque des séries de données sont ajoutées ou supprimées sur les axes, définissez sa propriété AutoUpdate sur 'off'.
y3 = cos(3*x); plot(x,y3,'DisplayName','cos(3x)') hold off
Supprimez la légende.
legend('off')
Vous pouvez afficher une mosaïque de tracés avec les fonctions tiledlayout et nexttile. Utilisez la fonction tiledlayout pour créer une disposition de graphique en mosaïque de 2 x 1. Utilisez la fonction nexttile pour créer les objets axes, ax1 et ax2. Tracez des données aléatoires sur chaque axe. Ajoutez une légende au tracé supérieur en spécifiant ax1 comme premier argument en entrée de la fonction 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'})
Tracez deux lignes. Spécifiez les étiquettes de la légende dans les commandes de tracé en définissant la propriété DisplayName avec le texte souhaité. Ajoutez ensuite une légende.
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
Pour exclure une ligne de la légende, spécifiez son étiquette sous forme de vecteur ou chaîne de caractères vide. Par exemple, tracez deux ondes sinusoïdales et ajoutez une ligne zéro interrompue en appelant la fonction yline. Créez ensuite une légende et excluez la ligne zéro en spécifiant '' pour son étiquette.
x = 0:0.2:10; plot(x,sin(x),x,sin(x+1)); hold on yline(0,'--') legend('sin(x)','sin(x+1)','')
Tracez quatre lignes. Créez une légende dans la zone nord-ouest des axes. Spécifiez le nombre de colonnes de la légende avec la propriété 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)
Par défaut, la légende ordonne les éléments de haut en bas le long de chaque colonne. Pour les ordonner de gauche à droite le long de chaque ligne, définissez la propriété Orientation sur 'horizontal'.
Depuis R2023b
Vous pouvez inverser l’ordre des éléments de la légende en définissant la propriété Direction de cette dernière. Par exemple, tracez quatre lignes et ajoutez une légende.
plot([4 5 6 7; 0 1 2 3]) lgd = legend("First","Second","Third","Fourth");
Inversez l’ordre des éléments de la légende.
lgd.Direction = "reverse";
Lorsque vous souhaitez que plusieurs tracés partagent une même légende, vous pouvez afficher celle-ci dans une vignette distincte de la mosaïque. Vous pouvez la placer à l’intérieur de la grille de vignettes ou dans une vignette externe.
Créez trois tracés dans une disposition de graphique en mosaïque.
t = tiledlayout('flow','TileSpacing','compact'); nexttile plot(rand(5)) nexttile plot(rand(5)) nexttile plot(rand(5))
Ajoutez une légende partagée et déplacez-la vers la quatrième vignette.
lgd = legend; lgd.Layout.Tile = 4;
Ajoutez ensuite un quatrième tracé et déplacez la légende vers la vignette à l’est.
nexttile
plot(rand(5))
lgd.Layout.Tile = 'east';
Si vous ne souhaitez pas inclure tous les objets graphiques tracés dans la légende, vous pouvez spécifiez ceux à inclure.
Tracez trois lignes et renvoyez les objets Line créés. Créez une légende incluant seulement deux des lignes. Spécifiez le premier argument en entrée sous forme de vecteur contenant les objets Line à inclure.
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'})
Créez un tracé et ajoutez une légende avec un balisage LaTeX en appelant la fonction legend et en définissant la propriété Interpreter sur 'latex'. Encadrez le balisage avec des symboles dollar ($).
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');
Tracez deux lignes et créez une légende. Ajoutez ensuite un titre à la légende.
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')
Tracez deux lignes et créez une légende dans le coin inférieur gauche des axes. Supprimez ensuite l’arrière-plan et le contour de la légende.
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')
Vous pouvez modifier divers aspects d’une légende en définissant des propriétés. Vous pouvez définir des propriétés en spécifiant des arguments nom-valeur lorsque vous appelez legend ou vous pouvez définir les propriétés de l’objet Legend après avoir appelé legend.
Tracez quatre lignes de données aléatoires. Créez une légende et affectez l’objet Legend à la variable lgd. Définissez les propriétés FontSize et TextColor avec des arguments nom-valeur.
rdm = rand(4);
plot(rdm)
lgd = legend({'Line 1','Line 2','Line 3','Line 4'},...
'FontSize',12,'TextColor','blue');
Modifiez la légende après sa création en faisant référence à lgd. Définissez la propriété NumColumns en plaçant un point entre l’objet et le nom de la propriété.
lgd.NumColumns = 2;
Depuis R2024b
Vous pouvez spécifier la largeur des icônes de la légende en définissant la propriété IconColumnWidth. Par exemple, tracez une ligne et deux jeux de données dispersées.
% 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
Ajoutez une légende horizontale en haut du tracé. Comme l’icône de la ligne est plus large que les icônes des deux marqueurs, la légende contient de l’espace vide superflu autour des icônes des marqueurs.
lgd = legend("Expected","Sample 1","Sample 2"); lgd.Location = "north"; lgd.Orientation = "horizontal";
Réduisez la largeur de la colonne de l’icône en définissant la propriété IconColumnWidth à 10. Ainsi, l’icône de la ligne est raccourcie et l’espace autour des marqueurs est réduit.
lgd.IconColumnWidth = 10;
Arguments d'entrée
Arguments nom-valeur
Spécifiez des paires d’arguments facultatifs en tant que Name1=Value1,...,NameN=ValueN, où Name est le nom de l'argument et Value la valeur correspondante. Les arguments nom-valeur doivent apparaître après les autres arguments, mais l’ordre des paires n’a pas d’importance.
Si votre version est antérieure à la R2021a, utilisez des virgules pour séparer chaque nom et chaque valeur, et placez Name entre guillemets.
Exemple : legend({'A','B'},'TextColor','blue','FontSize',12) crée une légende avec une police bleue de 12 points.
Remarque
Les propriétés répertoriées ici ne sont qu’un sous-ensemble. Pour obtenir la liste complète, consultez Legend Properties.
Vous pouvez également spécifier certaines couleurs usuelles par leur nom. Cette table répertorie les options de couleur nommées, les triplets RGB équivalents et les codes couleur hexadécimaux.
| Nom de couleur | Abréviation | Triplet RGB | Code couleur hexadécimal | Apparence |
|---|---|---|---|---|
"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" | Non applicable | Non applicable | Non applicable | Aucune couleur |
Cette table énumère les palettes de couleurs par défaut pour les tracés dans les thèmes clairs et sombres.
| Palette | Couleurs de la palette |
|---|---|
Avant R2025a : La plupart des tracés utilisent ces couleurs par défaut. |
|
|
|
Vous pouvez obtenir les triplets RGB et les codes couleur hexadécimaux de ces palettes à l’aide des fonctions orderedcolors et rgb2hex. Par exemple, obtenez les triplets RGB de la palette "gem" et convertissez-les en codes couleur hexadécimaux.
RGB = orderedcolors("gem");
H = rgb2hex(RGB);Avant R2023b : Obtenez les triplets RGB à l’aide de RGB = get(groot,"FactoryAxesColorOrder").
Avant R2024a : Obtenez les codes couleur hexadécimaux à l’aide de H = compose("#%02X%02X%02X",round(RGB*255)).
Exemple : [0 0 1]
Exemple : 'blue'
Exemple : '#0000FF'
Arguments de sortie
Conseils
Pour labelliser plus de 50 objets dans la légende, spécifiez une étiquette pour chaque objet. Sinon,
legenddécrit seulement les 50 premiers objets du graphique.
Algorithmes
Le fait d’appeler à nouveau la fonction
legendne réinitialise pas les propriétés de la légende telles que l’emplacement ou l’orientation. Si une légende existe, la fonctionlegendla met à jour. Un objetAxesne peut avoir qu’une légende.La légende tient compte de la visibilité des objets graphiques sur les axes. Les objets graphiques avec la propriété
Visibledéfinie sur'off'apparaissent grisés dans la légende.
Historique des versions
Introduit avant R2006aL’ordre par défaut des éléments de la légende pour les diagrammes à barres et les graphiques en aires empilés (verticaux) est désormais inversé pour correspondre à l’ordre d’empilement du graphique. Auparavant, l’ordre d’affichage des éléments de la légende était l’opposé de l’ordre d’empilement du graphique.
Pour conserver l’ordre des versions précédentes, définissez la propriété Direction de la légende sur "normal".
Lorsque vous appelez la fonction legend en spécifiant une étiquette sous forme de vecteur de caractères vide, de chaîne de caractères vide ou d’élément vide d’un cell array ou d’un tableau de chaînes de caractères, l’entrée correspondante est omise dans la légende. Dans les versions R2020b et antérieures, l’entrée s’affiche sans étiquette dans la légende.
Par exemple, le code suivant trace deux ondes sinusoïdales et une ligne de référence à y=0. Il crée ensuite une légende avec trois étiquettes, la dernière des trois étant vide. Dans la version R2020b, la troisième ligne s’affiche sans étiquette dans la légende. Dans la version R2021a, la troisième ligne est omise dans la légende.
x = 0:0.2:10; plot(x,sin(x),x,sin(x+1)); hold on yline(0,'--') legend('sin(x)','sin(x+1)','')
Pour conserver une entrée sans étiquette dans la légende, insérez un caractère d’espace dans l’étiquette. Par exemple, pour mettre à jour le code précédent, spécifiez la dernière étiquette sous forme de vecteur de caractères contenant un espace (' ').
legend('sin(x)','sin(x+1)',' ')
Si vous ne voulez pas afficher de caractère d’espace, vous pouvez passer les objets ligne individuels à la fonction legend avec un tableau d’étiquettes. Pour obtenir les objets ligne individuels, appelez chaque fonction de tracé avec un argument en sortie.
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)',''});
