文档

传说

给坐标轴添加图例

语法

传说
传奇(labelN label1…)
传奇(标签)
传奇(子集,___
传奇(目标,___
传奇(___、“位置”lcn)
传奇(___、“取向”ornt)
传奇(___、名称、值)
传奇(bkgd)
LGD =传说(___
[lgd,icons,plots,txt] = legend(___
传奇(vsbl)
传奇(“了”)

描述

例子

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

例子

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

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

例子

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

例子

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

例子

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

例子

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

例子

传奇(___名称,值使用一个或多个名称-值对参数设置图例属性。设置属性时,必须使用单元格数组指定标签,例如传奇({“A”、“B”},字形大小,12).如果不想指定标签,请包含空单元格数组,例如传奇({},“字形大小”,12)

例子

传奇(bkgd,在那里bkgd“boxoff”,删除图例背景和轮廓。的默认值bkgd“boxon”,显示图例背景和轮廓。

例子

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

乐金显示器图标情节三种] =传奇(___另外,返回用于创建图例图标的对象、绘制在图中的对象和标签文本数组。不推荐使用这种语法。它创建的图例不支持某些功能,比如添加图例标题。金宝app此外,当您在坐标轴上添加或删除数据序列时,图例不会自动更新。相反,使用LGD =传说(__)返回传说对象和集合传奇人物属性

传奇(vsbl控制图例的可见性,其中vsbl“隐藏”“显示”,或“切换”

例子

传奇(“了”)删除图例。

例子

全部折叠

绘制两条线并在当前轴上添加一个图例。控件的输入参数指定图例标签传说函数。

X = -pi:pi/20:pi;y = sin(x);情节(x, y₁)Y2 = cosx;情节(x, y2,“——”)举行传奇(“sin (x)”“cos (x)”

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

X = linspace(-3,3,25);y = sin(x);情节(x, y₁,“DisplayName的”“sin (x)”)举行Y2 = cosx;情节(x, y2,“——”“DisplayName的”“cos (x)”)传说(“显示”

绘制一条线并在轴线上添加一个图例。然后再画一条线。图例将自动更新,以在图例中包含新行。控件来控制新行的标签DisplayName属性作为名称-值对创建行。

X = linspace(0,10);y = sin(x);情节(x, y₁)传说(“一线”

持有Y2 = cosx;情节(x, y2,“DisplayName的”“二线”

注意:如果不希望图例在向轴添加或从轴中删除绘图时自动更新,则设置自动更新图例的参数to“关闭”,例如传奇(“第一线”,“自动更新”,“关闭”)

创建一个带有两个子图的图形,并返回两个轴对象,ax₁ax2.在每个子图中绘制随机数据。将图例添加到上面的子图,指定ax₁的第一个输入参数传说

Y1 = rand(3);Ax1 = subplot(2,1,1);Plot (y1) y2 = rand(5);Ax2 = subplot(2,1,2);情节(y2)传说(ax₁,1号线的“第2行”3号线的

绘制三条线并返回创建的图表线对象。然后,通过将第一个输入参数指定为要包含的图表线对象的矢量,创建一个仅包含两条线的图例。

X = linspace(0,3*pi);y = sin(x);P1 = plot(x,y1);持有Y2 = sin(x - /4)P2 = plot(x,y2);Y3 = sin(x - /2)P3 = plot(x,y3);持有传奇([p1 p3),“第一”“第三”

绘制两条线并添加一个图例。控件控制图例的位置位置财产。控件来控制方向取向财产。

X = -pi:pi/20:pi;y = sin(x);情节(x, y₁)Y2 = cosx;情节(x, y2,“——”)举行传奇(“sin (x)”“cos (x)”“位置”“西北”“定位”“水平”

画两条线,创建一个图例。然后,为图例添加标题。

X = -pi:pi/20:pi;y = sin(x);情节(x, y₁)Y2 = cosx;情节(x, y2)LGD =传说(“sin (x)”“cos (x)”);标题(乐金显示器,《我的传奇头衔》

画一个折线图和一个干图。向坐标轴添加图例,并使用名称-值对参数设置图例的属性。指定名称-值对参数时,必须使用单元格数组指定标签。

X = linspace(-3,3,25);y = sin(x);情节(x, y₁)Y2 = cosx;茎(x, y2)传奇({“sin (x)”“cos (x)”},“字形大小”12“输入TextColor”“蓝”

画一个折线图和一个干图。向坐标轴添加一个图例,并将图例对象分配给变量乐金显示器.然后,用乐金显示器在图例创建后修改图例的属性。

X = linspace(-3,3,25);y = sin(x);情节(x, y₁,“DisplayName的”“sin (x)”)举行Y2 = cosx;茎(x, y2,“DisplayName的”“cos (x)”)举行LGD =传说(“显示”);乐金显示器。font - size = 12;乐金显示器。输入TextColor =“蓝”;

创建一个柱状图和折线图。在坐标轴的左下角添加一个图例。然后,删除图例背景和轮廓。

X = linspace(0,2*pi,50);y = sin(x);茎(x, y₁,“DisplayName的”“sin (x)”)举行Y2 = cosx;情节(x, y2,“DisplayName的”“cos (x)”)举行传奇(“位置”“西南”)传说(“boxoff”

创建带有图例的图表。然后,删除图例。

情节(兰德(3))传说(1号线的“第2行”3号线的

传奇(“关闭”

输入参数

全部折叠

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

例子:图例(“Sin函数”,“Cos函数”)

例子:图例(“Sin函数”、“Cos函数”)

例子:传奇(‘\γ’,‘\σ’)

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

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

例子:legend({'Sin Function','Cos Function'})

例子:图例([“Sin函数”,“Cos函数”])

例子:legend(['Sin Function';'Cos Function'])

例子:传奇({‘\γ’,‘\σ’})

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

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

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

图例位置相对于轴,指定为这个表中列出的位置值之一。

价值 描述
“北” 轴内顶部
“南” 轴内底部
“东” 轴的内右
“西方” 轴的左内侧
“东北” 轴的右上方(默认为二维轴)
“西北” 在坐标轴的左上角
“东南” 在轴的右下方
“西南” 在轴的左下方
“northoutside” 在坐标轴之上
“southoutside” 在坐标轴下面
“eastoutside” 在坐标轴的右边
“westoutside” 在坐标轴的左边
“northeastoutside” 轴的右上角外(默认为3d轴)
“northwestoutside” 在坐标轴的左上角外
“southeastoutside” 轴的右下角外
“southwestoutside” 轴的左下角外
“最佳” 在与绘图数据冲突最少的轴内
“bestoutside” 在坐标轴的右边
“没有” 位置财产。使用位置属性以在自定义位置显示图例。

例子:传奇(“位置”,“northeastoutside”)

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

  • “垂直”-垂直堆叠图例项目。

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

例子:传奇(“取向”、“水平”)

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

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

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

例子:传奇(“boxoff”)

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

  • “隐藏”-隐藏图例。

  • “显示”—显示图例,如果图例不存在,则创建图例。

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

例子:传奇(隐藏的)

名称-值对参数

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

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

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

全部折叠

文本颜色,指定为RGB三元组或表中列出的颜色选项之一。默认颜色为黑色,RGB三元组值为[00 00 00]

对于自定义颜色,请指定RGB三元组。RGB三元组是一个包含三个元素的行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在这个范围内[0, 1];例如,[0.4 0.6 0.7].或者,您可以通过名称指定一些常见的颜色。该表列出了长、短颜色名称选项以及等效的RGB三元组值。

选项 描述 等效RGB三元组
“红色”“r” 红色的 [1 0 0]
“绿色”‘g’ 绿色 [0 10 10]
“蓝”“b” 蓝色的 [0 0 1]
“黄色”“y” 黄色的 [10]
“红色”“米” 品红色的 [10]
“青色”“c” 青色 [0 11 1]
“白色”' w ' 白色 [11 11]
“黑”“k” 黑色的 [00 00 00]
“没有” 没有颜色 不适用

例子:[0 0 0.5]

例子:“蓝”

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

如果您更改轴字体大小,则MATLAB®的字体大小传说对象设置为轴字体大小的90%。如果手动设置传说对象的字体大小,则更改轴的字体大小不会影响传说对象。

文本字符的解释,指定为以下值之一:

  • “泰克斯”-使用TeX标记的子集解释字符。

  • “乳胶”-使用LaTeX标记解释字符。

  • “没有”-显示文字字符。

特克斯标记

默认情况下,MATLAB支持TeX标记金宝app的子集。使用TeX标记可以添加上标和下标,修改字体类型和颜色,并在文本中包含特殊字符。

的支持的修饰符金宝app翻译属性设置为“泰克斯”.修饰语在文本结束前一直有效。上标和下标是一个例外,因为它们只修改下一个字符或花括号内的字符。

修饰符 描述 例子
^ {} 上标 “文本^{上标}’
_ {} 下标 “text_{下标}’
\男朋友 大胆的字体 “\ bf文本”
它\ 斜体字体 “\它文本”
\ sl 斜体字体(通常与斜体相同) “\ sl文本”
rm \ 正常的字体 “\ rm文本”
\字体名{说明符} 字体名称-设置说明符作为字体族的名称。您可以将它与其他修饰符结合使用。 “\字体名{快递}文本”
\字形大小{说明符} 字体大小-设置说明符以点为单位的数字标量值来更改字体大小。 ”字形大小{15}文本”
{说明符}\颜色 字体颜色-设置specifer作为这些颜色之一:红色的绿色黄色的品红色的蓝色的黑色的白色灰色的暗绿色橙色,或lightBlue “{品红}\颜色文本”
\颜色(rgb){说明符} 自定义字体颜色-设置说明符作为三元素RGB三元组。 “\颜色(rgb){0, 0.5, 0.5}文本”

表中列出了支持的特殊字符金宝app翻译属性设置为“泰克斯”

字符序列 象征 字符序列 象征 字符序列 象征

α

\ upsilon

υ

\ sim

\角

\ leq

\ ast

*

\气

χ

\ infty

β\

β

ψ

\ clubsuit

γ

ω

\ diamondsuit

δ

Γ

\ heartsuit

ϵ

Δ

\ spadesuit

ζ

Θ

\ leftrightarrow

\埃塔

η

Λ

\ leftarrow

θ

Ξ

\ Leftarrow

\ vartheta

ϑ

Π

\向上光标键

\极微小

ι

Σ

\ rightarrow

\卡巴

κ

\ Upsilon

ϒ

\ Rightarrow

λ

Φ

\ downarrow

µ

Ψ

\保监会

º

ν

Ω

下午\

±

ξ

\原则

\组

π

\存在

\ propto

ρ

倪\

\部分

σ

丛\

\子弹

\ varsigma

ς

\约

\ div

÷

τ

\再保险

\ neq

\枚

\ oplus

\ aleph

、即时通讯

\杯

\ wp

\ otimes

\ subseteq

\帕

\帽

中\

\ supseteq

\ supset

\ lceil

\子集

int \

\ cdot

·

阿\

ο

\ rfloor

\底片

¬

\微分算符

\ lfloor

\ *

x

\ ldots

\补

\清音

\ '

´

\楔

\ varpi

ϖ

\ 0

\ rceil

\捕杀

中期\

|

\三角

\ langle

\版权

©

乳胶标记

要使用LaTeX标记,请设置翻译财产“乳胶”.在文本周围使用美元符号,例如,使用'$\int_1^{20} x^ 2dx $'用于内联模式或'$$\int_1^{20} x^ 2dx $$'用于显示模式。

显示的文本使用默认的LaTeX字体样式。的字体名FontWeight,FontAngle属性没有效果。要更改字体样式,请使用LaTeX标记。

您可以在LaTeX解释器中使用的文本的最大长度是1200个字符。对于多行文本,每行减少大约10个字符。

有关LaTeX系统的更多信息,请参见LaTeX项目网站http://www.latex-project.org/

输出参数

全部折叠

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

Plot (rand(3)) LGD = legend(“line1”“么”“line3”);乐金显示器。font - size = 12;乐金显示器。FontWeight =“大胆”;

请注意

从R2014b开始传说函数返回传说对象。对于早期版本,它返回一个对象。

对象,用于创建图例图标和标签,返回为文本补丁,对象。

请注意

不建议使用此输出参数。

在坐标轴上绘制的对象,作为图形对象的矢量返回。

请注意

不建议使用此输出参数。

用于图例标签的文本,作为字符向量的单元格数组返回。

请注意

不建议使用此输出参数。方法访问标签字符串图例的属性。

更多关于

全部折叠

兼容性的考虑

  • 从R2017b开始,如果轴不存在,则传说函数创建它们。

  • 从R2017a开始,当您从轴上添加或删除数据系列时,图例会自动更新。如果不希望图例自动更新,请设置自动更新属性的传说“关闭”

提示

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

算法

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

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

R2006a之前引入

这个话题有帮助吗?