传说

向坐标轴添加图例

描述

传说为每个绘制的数据系列创建具有描述性标签的图例。对于标签,图例使用来自。的文本DisplayName数据系列的属性。如果DisplayName属性为空,则图例使用窗体的标签“dataN”。当您从轴中添加或删除数据系列时,图例将自动更新。此命令为返回的当前轴或图表创建图例gca。如果当前轴为空,则图例为空。如果轴不存在,那么这个命令将创建它们。

传奇(label1,…, labelN设置图例标签。将标签指定为字符向量或字符串的列表,例如传说(“月”,“月”,“月”)

传奇(标签使用字符向量、字符串数组或字符矩阵(如)的单元格数组设置标签传奇({' 1 ',' 2 ',' 3月'})

传奇(子集___仅包括中列出的数据系列的图例项子集。指定子集作为图形对象的向量。您可以指定子集在指定标签之前或没有其他输入参数时。

传奇(目标___使用由。指定的轴或图表目标而不是当前的轴或图表。将目标指定为第一个输入参数。

传奇(___“位置”,lcn设置图例位置。例如,“位置”,“东北”将图例放置在坐标轴的右上角。在其他输入参数之后指定位置。

传奇(___“定位”,ornt,在那里ornt“水平”,并排显示图例项。默认为ornt“垂直”,其垂直堆叠的项目。

传奇(___名称,值设置使用一个或多个名称值对参数图例属性。当设置属性,则必须使用一个单元阵列的标签,如传奇({“A”、“B”},字形大小,12)。如果不希望指定标签,则应包括空单元格数组,如图例({}, '字号',12)

传奇(bkgd,在那里bkgd“boxoff”,删除传奇背景和大纲。默认为bkgd“boxon”,它显示图例的背景和概要。

乐金显示器=传奇(___返回传说对象。使用乐金显示器在创建图例后查询和设置图例的属性。有关属性列表,请参见传奇人物属性

传奇(vsbl控制着传奇,在这里的知名度vsbl“隐藏”'显示',或“切换”

传奇(“了”)删除的传说。

例子

全部折叠

绘制两行并在当前轴上添加一个图例。属性的输入参数指定图例标签传说功能。

x = linspace(0,π);日元= cos (x);积(X,Y)保持y2 = cos (2 * x);情节(x, y2)传说(“cos (x)”“因为(2 x)”

如果您添加或删除轴,因此传说更新的数据系列。通过设置控制新的数据系列的标签DisplayName财产作为创建过程中的名称 - 值对。如果不指定标签,那么Legend采用的形式的标签“dataN”

注意:如果不希望在向坐标轴添加或删除数据系列时自动更新图例,请设置自动更新传说中的属性“关闭”

y3 = cos (3 * x);情节(x, y3,“DisplayName的”“因为(3 x)”)举行

删除的传说。

传奇(“关闭”

从R2019b开始,可以使用tiledlayoutnexttile功能。调用tiledlayout函数创建一个2×1平铺图表布局。调用nexttile函数创建轴对象ax₁ax2。绘制在各轴的随机数据。通过指定一个传奇添加到上面的曲线ax₁作为第一个输入参数以传说

tiledlayout(2,1)Y1 =兰特(3);AX1 = nexttile;情节(Y1)Y2 =兰特(5);Ax2 = nexttile;情节(Y2)图例(AX1,{1号线的“第2行”3号线的})

画两条线。属性来指定绘图命令期间的图例标签DisplayName属性设置为所需的文本。然后,添加一个图例。

x = linspace(0,π);日元= cos (x);情节(x, y₁,“DisplayName的”“cos (x)”)举行y2 = cos (2 * x);图(X,Y 2,“DisplayName的”“因为(2 x)”)举行传说

绘制四条线。创建轴的西北地区的一个传奇。指定使用的传说列数NumColumns财产。

x = linspace(0,π);日元= cos (x);积(X,Y)保持y2 = cos (2 * x);积(X,Y2)Y3 = COS(3 * X);积(X,Y3)Y4 = COS(4 * X);图(X,Y 4)保持传奇({“cos (x)”“因为(2 x)”“因为(3 x)”“因为(4 x)”},“位置”“西北”“NumColumns”,2)

默认情况下,图例会沿着每一列从上到下排序。若要沿每一行从左向右排列项,请设置取向属性“水平”

如果不希望在图例中包含所有绘制的图形对象,则可以指定要包含的图形对象。

画出三条线,并返回线创建的对象。创建一个只包含两行内容的图例。的向量指定第一个输入参数线对象包括。

x = linspace(0,π);日元= cos (x);P1 =积(X,Y1);保持y2 = cos (2 * x);P2 =积(X,Y2);y3 = cos (3 * x);P3 =积(X,Y3);保持图例([P1 P3],{“第一”“第三”})

画出两条线,并创建一个传奇。接着,添加标题传说。

x = linspace(0,π);日元= cos (x);积(X,Y)保持y2 = cos (2 * x);情节(x, y2)乐金显示器=传奇(“cos (x)”“因为(2 x)”);标题(乐金显示器,“我的图例标题”

画出两条线,并在轴的左下角创造一个传奇。然后,取出传奇背景和大纲。

x = linspace(0,π);日元= cos (x);积(X,Y)保持y2 = cos (2 * x);情节(x, y2)传奇({“cos (x)”“因为(2 x)”},“位置”“西南”)传说(“boxoff”

通过设置修改图例外观传说属性。当您在使用名称 - 值对创建的传说,你可以设置属性传说命令。属性创建图例后还可以设置属性传说对象。

绘制四行随机数据。创建图例并分配传说对象变量乐金显示器。设置字体大小输入TextColor使用名称-值对的属性。在指定名称-值对参数时,必须使用单元格数组指定图例标签。

RDM =兰特(4);情节(RDM)LGD =图例({1号线的“第2行”3号线的4号线的},“字形大小”12'TEXTCOLOR'“蓝”

位置:‘东北’方向:‘垂直’字体大小:12位置:[0.7088 0.7034 0.1778 0.1957]单元:‘归一化’显示所有属性

在通过引用创建图例之后修改它乐金显示器。设置NumColumns属性使用对象点属性名表示法。

乐金显示器。NumColumns = 2;

输入参数

全部折叠

标签,作为字符向量或字符串的单独参数指定。要在标签中包含特殊字符或希腊字母,请使用TeX标记。有关选项表,请参见翻译财产。

例子:传奇(“Sin函数”,“因为函数”)

例子:传奇(“罪功能”,“因为函数”)

例子:图例( '\伽马', '\西格玛')

指定属于关键字的标签,例如“位置”“关闭”,使用字符向量的单元格数组、字符串数组或字符数组。

标签,指定为字符向量、字符串数组或分类数组的单元数组。要在标签中包含特殊字符或希腊字母,请使用TeX标记。有关选项表,请参见翻译财产。

例子:传奇({“罪函数”,“因为函数”})

例子:图例([ “SIN函数”, “COS函数”])

例子:图例({ '\伽马', '\西格玛'})

例子:传说(分类({ '阿拉巴马', '纽约'}))

数据序列包括在图例中,指定为图形对象的矢量。

指定为图例的目标对象,PolarAxes对象,GeographicAxes对象,或带。的图形对象LegendVisible属性,比如aGeographicBubbleChart对象。如果不指定目标,则传说方法返回的轴或图表gca命令。

某些图表不支持修改图例外观,如位置或返金宝app回传说对象作为输出参数..

图例位置相对于所述轴线,指定为在该表中列出的位置值中的一个。

价值 描述
“北” 轴内顶部
“南” 轴内底
'东' 坐标轴内侧
“西方” 坐标轴左侧内侧
'东北' 坐标轴右上角内侧(2-D轴默认)
“西北” 在坐标轴的左上方
“东南” 在坐标轴的右下角
“西南” 在轴的左下方
'northoutside' 上述轴
“southoutside” 以下轴
“eastoutside” 在坐标轴的右边
“westoutside” 在坐标轴的左边
'northeastoutside' 坐标轴右上角外(3-D轴默认)
“northwestoutside” 在坐标轴左上角的外面
'southeastoutside' 在坐标轴的右下角之外
“southwestoutside” 在坐标轴的左下角之外
“最佳” 内轴,其中至少冲突在您创建的传说时的情节数据时发生。如果情节数据发生变化,你可能需要的位置重置“最佳”
'bestoutside' 在坐标轴的右上角之外(当图例具有垂直方向时)或在坐标轴之下(当图例具有水平方向时)
'没有' 位置财产。使用位置属性以在自定义位置中显示图例。

例子:传说( '位置', 'northeastoutside')

方向,指定为以下值之一:

  • “垂直”-垂直堆叠传奇物品。

  • “水平”- 列出图例项并排侧。

例子:图例(“方向”,“横”)

图例框显示,指定为下列值之一:

  • “boxon”-显示图例背景和轮廓。

  • “boxoff”-不显示图例背景和轮廓。

例子:传奇(“boxoff”)

图例可见性,指定为以下值之一:

  • “隐藏”-隐藏传说。

  • “显示”- 显示图例,或者如果一个不存在创建一个传奇。

  • “切换”-切换图例可见性。

例子:传奇(隐藏的)

名称-值对的观点

指定可选的用逗号分隔的对名称,值参数。的名字是参数的名称和价值是对应的值。的名字必须出现在引号内。可以按任意顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:传奇({“A”、“B”},“输入TextColor”、“蓝”、“字形大小”,12)创建一个带有蓝色12点字体的图例。

注意

这里列出的属性是唯一的一个子集。有关完整列表,请参阅传奇人物属性

文本颜色,指定为RGB三元组、十六进制颜色代码、颜色名称或短名称。默认颜色为黑色,值为(0 0 0)

对于自定义颜色,请指定RGB三元组或十六进制颜色代码。

  • RGB三元组是一个三元素行向量,其元素指定颜色的红色、绿色和蓝色组件的强度。强度必须在这个范围内[0,1];例如,(0.4 0.6 0.7)

  • 十六进制颜色代码是一个以散列符号()后面跟3或6个十六进制数字,其范围从0F。这些值不区分大小写。因此,颜色代码“# FF8800”“# ff8800”“# F80”,'#F80'是等价的。

或者,您可以通过名称指定一些常见的颜色。这个表列出了指定的颜色选项、等效的RGB三联表和十六进制颜色代码。

颜色名称 短名称 RGB三元 十六进制颜色代码 外观
'红色' 'R' (1 0 0) '#FF0000'

“绿色” ‘g’ (0 1 0) '#00FF00'

“蓝” “b” (0 0 1) “# 0000 ff”

“青色” “c” (0 1 1) “# 00飞行符”

“红色” “米” (1 0 1) “#就”

“黄色” “y” [1 1 0] '#FFFF00'

“黑” “k” (0 0 0) # 000000的

'白色' 'W' [1 1 1] “# FFFFFF”

'没有' 不适用 不适用 不适用 没有颜色

下面是RGB三进制和十六进制颜色代码的默认颜色MATLAB®用于多种类型的地块。

RGB三元 十六进制颜色代码 外观
[0 0.4470 0.7410] “# 0072 bd”

(0.8500 0.3250 0.0980) '#D95319'

(0.9290 0.6940 0.1250) “# EDB120”

(0.4940 0.1840 0.5560) “# 7 e2f8e”

(0.4660 0.6740 0.1880) “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) “# A2142F”

例子:(0 0 1)

例子:“蓝”

例子:“# 0000 ff”

字体大小,指定为以点为单位的大于零的标量值。默认字体大小取决于特定的操作系统和地区。

如果您更改了坐标轴的字体大小,那么MATLAB会自动将颜色栏的字体大小设置为坐标轴字体大小的90%。如果您手动设置了colorbar的字体大小,那么改变坐标轴的字体大小并不会影响colorbar的字体。

列数,指定为正整数。如果没有足够的图例项来填充指定的列数,则出现的列数可能会更少。

使用取向属性来控制图例项是否沿着每列或沿每一行按顺序出现。

例子:乐金显示器。NumColumns = 3

输出参数

全部折叠

传说对象。使用乐金显示器查看或在创建后修改的图例的性质。

plot(rand(3)) lgd = legend(“line1”“么”“line3”);乐金显示器。F在tSize = 12; lgd.FontWeight =“大胆”;

提示

  • 若要在图例中标记20多个对象,请为每个对象指定一个标签。否则,传说只描述图中的前20个对象。

算法

  • 回忆的传说函数不重置图例属性,如位置或方向。如果存在传奇,那么传说功能更新现有的传说。一个对象只能有一个传说。

  • 传说反映了图形对象的在轴的可见性。有一个图形对象可见属性设置为“关闭”在图例中显示为灰色的项目。

兼容性的考虑

全部展开

行为R2018b改变

行为R2017b改变

行为R2017a改变

不推荐从R2014b开始

之前介绍过的R2006a