参照线

x值恒定的垂直线

在页面中全部折叠

语法

参照线(x)

参照线(x, LineSpec)

参照线(x, LineSpec、标签)

参照线(___、名称、值)

参照线(ax,___）

xl =参照线(___）

描述

例子

参照线(x）在一个或多个处创建竖线x-当前坐标轴中的坐标。例如,参照线(2)在x = 2．

例子

参照线(x，LineSpec）指定线条样式、线条颜色或两者都指定。例如,参照线(20 33[12],“——b”)创建三条蓝色虚线。

例子

参照线(x，LineSpec，标签）向行添加标签。

例子

参照线(___，名称,值）使用一个或多个名值对参数指定常量行属性。有关属性列表，请参见ConstantLine属性．在所有其他输入参数之后指定名称-值对。

例子

参照线(斧头，___）在指定的轴而不是当前轴上创建行。

例子

xl =参照线(___）返回一个ConstantLine对象或的数组ConstantLine对象。使用xl在创建行后修改或查询该行的属性。

例子

全部折叠

创建垂直线

打开生活的脚本

在x = 3处画一条垂直线。

参照线(3);

图中包含一个axes对象。axis对象包含一个constantline类型的对象。

添加一个标签

打开生活的脚本

要创建带有标签的行，还必须指定行样式。默认的线条样式是实线，“- - -”．

x = linspace (0, 6100);y = exp (x);情节(x, y)参照线(4.5,“- - -”，{“可接受的”，“限制”})；

图中包含一个axes对象。坐标轴对象包含两个类型为line、constantline的对象。

创建带标签的多行

打开生活的脚本

创建一个正态分布随机数向量，并在直方图中显示它们。然后在平均值处、平均值以下一个标准差处和平均值以上一个标准差处画三条竖线。

数据= 5 * randn(1500) + 20;直方图(数据、“FaceAlpha”, 0.1,“EdgeAlpha”, 0.1);m =意味着(数据);s =性病(数据);参照线((m m m + s),“- - -”，{1标准开发。，“平均”，“+ 1标准开发。”})

图中包含一个axes对象。坐标轴对象包含4个直方图、常量线类型的对象。

指定线条样式和颜色

打开生活的脚本

在x = 5处画一条红色虚线。

参照线(5“——r”）;

图中包含一个axes对象。axis对象包含一个constantline类型的对象。

添加图例并指定标签对齐方式

打开生活的脚本

为图例创建一个垂直的虚线，其中包含标签和显示名称。

Y = [3187 2693 1771 1826 1958 3222 1645];barh (y,“DisplayName的”，每日销售的) xl = xline(2328，“-”。，“平均”，“DisplayName的”，的平均销售）;

图中包含一个axes对象。坐标轴对象包含两个类型为bar和constantline的对象。这些对象代表每日销售额，平均销售额。

调整标签的垂直和水平对齐，然后显示图例。

xl。LabelVerticalAlignment =“中间”；xl。LabelHorizontalAlignment =“中心”；传奇(“显示”）;

图中包含一个axes对象。坐标轴对象包含两个类型为bar和constantline的对象。这些对象代表每日销售额，平均销售额。

添加线到不同的轴

打开生活的脚本

调用tiledlayout函数创建2 × 1平铺图表布局。调用nexttile函数来创建坐标轴对象ax₁而且ax2．然后画出每个坐标轴。通过将坐标轴传递给参照线函数。

tiledlayout (2, 1) ax₁= nexttile;x = linspace (0, 10200);日元= cos (x);Plot (ax1,x,y1) ax2 = nexttile;y2 = sin (x);情节(ax2, x, y2)参照线(ax₁,π/ 2,“:”，“因为(\π/ 2)= 0的）;参照线(ax2,π,“:”，“罪(\π)= 0”）;

图中包含2个轴对象。坐标轴对象1包含两个类型为line、constantline的对象。坐标轴对象2包含两个类型为line、constantline的对象。

输入参数

全部折叠

`x`- - - - - -x坐标
标量|向量

x-coordinates，指定为标量或包含数值、类别、日期时间或持续时间值的向量。的数据类型x的数据类型必须匹配x设在。

例子:参照线(10)显示一行于x = 10．

例子:参照线(20 33 [13])显示行x = 13，x = 20,x = 33．

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64|逻辑|分类|datetime|持续时间

`LineSpec`- - - - - -线条样式和颜色
特征向量|字符串标量

线条样式和颜色，指定为字符向量或包含字符和符号的字符串标量。字符和符号可以以任何顺序出现。您可以指定线条样式、线条颜色或两者都指定。标记符号，例如“o”将被忽略。

例子:“——g”是一条绿色虚线。

线条样式	描述	产生的线
`“-”`	实线
`”——“`	虚线
`”:“`	虚线
`“-”。`	Dash-dotted线

颜色名称	短名称	外观
`“红色”`	`“r”`
`“绿色”`	`‘g’`
`“蓝”`	`“b”`
`“青色”`	`“c”`
`“红色”`	`“米”`
`“黄色”`	`“y”`
`“黑”`	`“k”`
`“白色”`	`' w '`

`斧头`- - - - - -目标轴
`轴`对象

目标轴，指定为轴对象。如果你愿意，可以使用这个参数参照线在当前轴以外的轴上绘制。

`标签`- - - - - -行标签
`”`(默认)|特征向量|字符串标量|字符向量的单元格数组|字符串数组

行标签，指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。

单行创建标签

指定字符向量或字符串标量以显示一行文本。若要显示多行文本，请指定字符向量的单元格数组或字符串数组。

演讲如何指定标签 例子

一行文字

指定字符向量或字符串标量。

演讲	如何指定`标签`	例子
一行文字	指定字符向量或字符串标量。	参照线(12,“- - -”，“样本”）
多行文本	指定字符向量的单元格数组或字符串数组。数组中的每个元素都是一行不同的文本。	参照线(12,“- - -”，{“样本”，“x = 12”})

参照线(12,“- - -”，“样本”）

在坐标轴上有标记的竖线

多行文本

指定字符向量的单元格数组或字符串数组。数组中的每个元素都是一行不同的文本。

参照线(12,“- - -”，{“样本”，“x = 12”})

轴中的竖线，其标签包含两行文本

为多行创建标签

指定字符向量或字符串标量，以便在所有行的旁边显示相同的标签。指定字符向量的单元格数组或字符串数组，以显示每一行的不同标签。

演讲如何指定标签 例子

一个共享文本标签

指定字符向量或字符串标量。

演讲	如何指定`标签`	例子
一个共享文本标签	指定字符向量或字符串标量。	参照线(20 33 [13],“- - -”，“样本”）
每一行都有不同的标签	指定字符向量的单元格数组或字符串数组。数组中的每个元素都是不同行的标签。元素的个数`标签`数组的长度必须匹配`x`．	标签= {样品1的，示例2的，“示例3”};参照线(20 33 [13],“- - -”、标签)
不同的标签有一些多行标签	创建字符向量的单元格数组或字符串数组。使用`sprintf`函数用于插入换行符(`' \ n '`)。	标签= {样品1的sprintf (的样品2 \ nx = 20)，“示例3”};参照线(20 33 [13],“- - -”、标签)

参照线(20 33 [13],“- - -”，“样本”）

坐标轴上的三条垂直线，带有匹配的标签

每一行都有不同的标签

指定字符向量的单元格数组或字符串数组。数组中的每个元素都是不同行的标签。元素的个数标签数组的长度必须匹配x．

标签= {样品1的，示例2的，“示例3”};参照线(20 33 [13],“- - -”、标签)

坐标轴上的三条垂直线，带有不同的标签

不同的标签有一些多行标签

创建字符向量的单元格数组或字符串数组。使用sprintf函数用于插入换行符(' \ n ')。

标签= {样品1的sprintf (的样品2 \ nx = 20)，“示例3”};参照线(20 33 [13],“- - -”、标签)

坐标轴上的三条垂直线，带有不同的标签。第二行的标签有两行文本。

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名-值参数必须出现在其他参数之后，但对的顺序并不重要。

在R2021a之前，名称和值之间用逗号隔开，并括起来的名字在报价。

例子:参照线(5“LabelVerticalAlignment”“中产”)将标签的垂直对齐方式指定为“中间”．

请注意

这里列出的属性只是一个子集。有关完整列表，请参见ConstantLine属性．

`颜色`- - - - - -线颜色
`(0.15 0.15 0.15)`(默认)|RGB值|十六进制颜色代码|`“r”`|`‘g’`|`“b”`|……

线色，指定为RGB三元组、十六进制颜色编码、颜色名称或短名称。

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

RGB三元组是一个三元素行向量，其元素指定颜色的红、绿、蓝成分的强度。强度必须在这个范围内[0, 1]例如,(0.4 0.6 0.7)．
十六进制颜色码是字符向量或以散列符号(＃)之后是三个或六个十六进制数字，取值范围从0来F．这些值不区分大小写。因此，颜色编码“# 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)`	`“# 00飞行符”`
`“红色”`	`“m”`	`(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”`