主要内容

传奇

向轴添加图例

描述

例子

传奇为每个绘制的数据系列创建带有描述性标签的图例。对于标签,图例使用来自DisplayName数据系列的属性。如果DisplayName属性为空,则图例将使用表单的标签“达坦”. 从轴添加或删除数据系列时,图例会自动更新。此命令在当前轴中创建图例,该图例由gca命令。如果当前轴为空,则图例为空。如果不存在轴,则传奇创建笛卡尔坐标轴。

例子

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

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

例子

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

例子

传奇(目标___使用指定的轴或独立可视化目标而不是当前轴。指定目标作为第一个输入参数。

例子

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

例子

传奇(___“定位”,奥尔特哪里奥尔特“水平”,并排显示图例项。默认的奥尔特“垂直”,它垂直地将项目堆叠起来。

例子

传奇(___名称,值使用一个或多个名称-值对参数设置图例属性。

例子

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

lgd=图例(___返回传奇对象。使用lgd在图例创建后查询和设置其属性。有关属性列表,请参阅图例属性

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

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

例子

全部折叠

绘制两条线并在当前坐标轴上添加图例。属性的输入参数指定图例标签传奇函数。

x = linspace(0,π);日元= cos (x);情节(x, y₁)在…上y2 = cos (2 * x);情节(x, y2)传说(‘cos(x)’‘cos(2x)’

图中包含一个轴对象。轴对象包含两个类型为line的对象。这些对象代表cos(x) cos(2x)

如果从坐标轴中添加或删除数据系列,图例将相应更新。控件来控制新数据系列的标签DisplayName属性在创建期间作为名称-值对。如果您没有指定标签,则图例将使用表单的标签“达坦”

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

y3 = cos (3 * x);情节(x, y3,“显示名称”‘cos(3x)’)持有

图中包含一个轴对象。轴对象包含3个类型为line的对象。这些对象代表cos(x) cos(2x) cos(3x)

删除的传说。

传奇(“关”

图中包含一个轴对象。轴对象包含3个类型为line的对象。这些对象代表cos(x) cos(2x) cos(3x)

从R2019b开始,可以使用tiledlayoutnexttile函数。调用tiledlayout函数创建一个2乘1的平铺图表布局。调用nexttile函数创建轴对象ax1ax2.在每个坐标轴上绘制随机数据。通过指定将图例添加到上部绘图ax1作为的第一个输入参数传奇

Tiledlayout (2,1) y1 = rand(3);ax₁= nexttile;Plot (y1) y2 = rand(5);ax2 = nexttile;情节(y2)传说(ax₁,{“第1行”“第2行”“第3行”})

图中包含2个轴对象。坐标轴对象1包含3个类型为line的对象。这些对象代表1号线,2号线,3号线。axis对象2包含5个类型为line的对象。

打印两条线。通过设置DisplayName属性设置为所需的文本。然后,添加一个图例。

x = linspace(0,π);日元= cos (x);情节(x, y₁,“显示名称”‘cos(x)’)持有在…上y2 = cos (2 * x);情节(x, y2,“显示名称”‘cos(2x)’)持有传奇

图中包含一个轴对象。轴对象包含两个类型为line的对象。这些对象代表cos(x) cos(2x)

若要从图例中排除一行,请将其标签指定为空字符向量或字符串。例如,绘制两个正弦波,并通过调用yline函数。然后创建图例,并通过指定其标签为排除零行''

x = 0:0.2:10;情节(x, sin (x), x, sin (x + 1));持有在…上yline(0,“——”)传奇(“sin (x)”“sin (x + 1)”''

图中包含一个轴对象。轴对象包含三个对象的类型线,常量线。这些对象表示sin(x) sin(x+1)

四行。在轴线的西北区域创建一个传说。属性指定图例列的数目NumColumns财产。

x = linspace(0,π);日元= cos (x);情节(x, y₁)在…上y2 = cos (2 * x);求(x,y2) y3 = cos(3*x);Plot (x,y3) y4 = cos(4*x);情节(x, y4)传奇({‘cos(x)’‘cos(2x)’‘cos(3x)’“因为(4 x)”},...“位置”“西北”“NumColumns”,2)

图中包含一个轴对象。轴对象包含4个类型为line的对象。这些对象代表cos(x) cos(2x) cos(3x) cos(4x)

默认情况下,图例沿每列从上到下排列项目。若要改为沿每行从左到右排列项目,请设置取向财产“水平”

当您希望在两个或多个图之间共享图例时,可以在布局的单独平铺中显示图例。您可以将图例放置在贴图网格中,或放置在外部贴图中。

在平铺图表布局中创建三个地块。

t = tiledlayout (“流”“瓦莱斯帕奇”“紧凑”)下一块地皮(兰特(5))下一块地皮(兰特(5))下一块地皮(兰特(5))

图中包含3个轴对象。axis对象1包含5个类型为line的对象。axis对象2包含5个类型为line的对象。坐标轴对象3包含5个类型为line的对象。

添加共享图例,并将其移动到第四个平铺。

乐金显示器=传奇;lgd.Layout.Tile = 4;

图中包含3个轴对象。axis对象1包含5个类型为line的对象。axis对象2包含5个类型为line的对象。坐标轴对象3包含5个类型为line的对象。

接下来,添加第四个绘图并将图例移动到东平铺。

nexttile绘图(兰特(5))lgd.Layout.Tile=“东”

图中包含4个轴对象。axis对象1包含5个类型为line的对象。axis对象2包含5个类型为line的对象。坐标轴对象3包含5个类型为line的对象。axis对象4包含5个类型为line的对象。

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

画三行,然后返回创建对象。创建仅包含两行的图例。将第一个输入参数指定为对象包括。

x = linspace(0,π);日元= cos (x);p1 =情节(x, y1);持有在…上y2 = cos (2 * x);p2 =情节(x, y2);y3 = cos (3 * x);p3 =情节(x, y3);持有传奇([p1 p3) {“第一”“第三”})

图形包含一个Axis对象。Axis对象包含3个line类型的对象。这些对象表示第一个、第三个。

创建绘图,并通过调用传奇函数和设置口译译员财产“乳胶”.用美元符号包围标记().

x=0:0.1:10;y=sin(x);dy=cos(x);绘图(x,y,x,dy);图例(“$sin(x)$”“美元\压裂{d} {dx} sin (x)的美元“翻译”“乳胶”);

图中包含一个轴对象。轴对象包含两个类型为line的对象。这些对象表示$sin(x)$, $\frac{d}{dx}sin(x)$。

画两条线,创造一个传奇。然后,给图例添加一个标题。

x = linspace(0,π);日元= cos (x);情节(x, y₁)在…上y2 = cos (2 * x);情节(x, y2)lgd=图例(‘cos(x)’‘cos(2x)’);头衔(lgd),“我的传奇称号”

图中包含一个轴对象。轴对象包含两个类型为line的对象。这些对象代表cos(x) cos(2x)

绘制两条线并在坐标轴的左下角创建一个图例。然后,移除图例背景和轮廓。

x = linspace(0,π);日元= cos (x);情节(x, y₁)在…上y2 = cos (2 * x);情节(x, y2)传奇({‘cos(x)’‘cos(2x)’},“位置”“西南”)传奇(“boxoff”

图中包含一个轴对象。轴对象包含两个类型为line的对象。这些对象代表cos(x) cos(2x)

通过设置修改图例外观传奇属性。属性中的名称-值对创建图例时,可以设置属性传奇命令。属性创建图例后,还可以设置属性传奇对象。

绘制四行随机数据。创建图例并分配传奇对象转换为变量lgd.设置字形大小文字颜色使用名称-值对的属性。

rdm =兰德(4);图(rdm) LGD = legend({“第1行”“第2行”“第3行”“第4行”},...“字体大小”,12,“输入TextColor”“蓝色”);

图中包含一个Axis对象。Axis对象包含4个line类型的对象。这些对象表示第1行、第2行、第3行和第4行。

在图例创建之后,通过引用来修改图例lgd.设置NumColumns属性使用对象点属性名称表示法。

lgd.NumColumns=2;

图中包含一个Axis对象。Axis对象包含4个line类型的对象。这些对象表示第1行、第2行、第3行和第4行。

输入参数

全部折叠

标签,指定为字符向量或字符串的逗号分隔列表。

要从图例中排除项目,请将相应标签指定为空字符向量或字符串。

若要在标签中包含特殊字符或希腊字母,请使用TeX或LaTeX标记。有关选项表,请参见口译译员财产。

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

例子:图例('Sin函数','Cos函数')

例子:图例(“正弦函数”、“余弦函数”)

例子:图例(“样本A”、“样本C”)

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

标签,指定为字符向量、字符串数组或类别数组的单元格数组。

要从图例中排除项目,请将相应标签指定为单元格数组中的空字符向量,或字符串数组中的空字符串。

若要在标签中包含特殊字符或希腊字母,请使用TeX或LaTeX标记。有关选项表,请参见口译译员财产。

例子:图例({'Sin函数','Cos函数'})

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

例子:传奇({“样本”,“示例C”})

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

例子:传奇(分类({“阿拉巴马”、“纽约”}))

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

目标的图例,指定为斧头对象,一个北极星对象,一个地理对象,或使用传奇可见属性,例如地理气泡图对象如果未指定目标,则传奇函数使用gca命令作为目标。

独立可视化不支持修改图例外观,如位置,或返回万博1manbetx传奇对象作为输出参数。。

与坐标轴相关的图例位置,指定为表中列出的位置值之一。

价值 描述
“北” 轴内顶
“南方” 轴的内部底部
“东” 轴的右内侧
“西部” 轴的左内侧
“东北” 轴的右上角内侧(默认为二维轴)
“西北” 在坐标轴的左上方
“东南” 轴的右下角内侧
“西南” 轴的左下角内侧
“northoutside” 以上轴
“南外” 轴下
“东区” 在轴线的右边
“西区外” 在坐标轴的左边
“northeastoutside” 轴的右上角外(3-D轴的默认值)
“西北外” 在坐标轴的左上角外面
“southeastoutside” 轴的右下角外侧
“西南外” 在坐标轴的左下角外面
“最好的” 在坐标轴内,在您创建图例时,与情节数据发生冲突的地方最少。如果绘图数据发生了变化,您可能需要将位置重置为“最好的”
“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] “# 00 ff00”

绿色样品

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

样品的颜色是蓝色的

“青色” “c” [0 1 1] “#00FFFF”

青色样品

“红色” “米” [1 0 1] “#FF00FF”

样品的颜色为洋红色

“黄色” “y” (1 1 0) “# FFFF00”

黄色样品

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

黑色样品

“白色” ' w ' (1 1 1) “# FFFFFF”

样品的颜色为白色

“没有” 不适用 不适用 不适用 没有颜色

以下是默认颜色的RGB三元组和十六进制颜色代码®用于多种类型的绘图。

RGB值 十六进制颜色代码 外观
[0 0.4470 - 0.7410) “#0072BD”

RGB三重态样本[0.4470 0.7410],显示为深蓝色

(0.8500 0.3250 0.0980) “# D95319”

RGB三联体样品[0.8500 0.3250 0.0980],呈深橙色

(0.9290 0.6940 0.1250) “# EDB120”

RGB三联体样品[0.9290 0.6940 0.1250],呈深黄色

(0.4940 0.1840 0.5560) “# 7 e2f8e”

样品RGB三片[0.4940 0.1840 0.5560],呈深紫色

(0.4660 0.6740 0.1880) “# 77 ac30”

样品RGB三联体[0.4660 0.6740 0.1880],呈中绿色

(0.3010 0.7450 0.9330) “# 4 dbeee”

RGB三联体样品[0.3010.7450 0.9330],显示为浅蓝色

[0.6350 0.0780 0.1840] “# A2142F”

RGB三元组样本[0.6350 0.0780 0.1840],呈暗红色

例子:(0 0 1)

例子:“蓝色”

例子:“# 0000 ff”

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

如果更改轴字体大小,则MATLAB会自动将颜色栏的字体大小设置为轴字体大小的90%。如果手动设置colorbar的字体大小,则更改轴字体大小不会影响colorbar字体。

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

使用取向属性以控制图例项是按列排列还是按行排列。

例子:lgd.NumColumns=3

输出参数

全部折叠

传奇对象。使用lgd查看或修改图例创建后的属性。

图(rand(3))“第1行”“么”“line3”); lgd.FontSize=12;重量=“大胆的”

提示

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

算法

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

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

兼容性考虑

全部展开

R2021a中的行为发生了变化

R2018b中行为改变

行为在R2017b中改变

在R2017a中行为改变

不建议从R2014b开始

在R2006a之前引入