yline

具有常量 y 值的水平线

全页折叠

语法

yline(y)

yline(y,LineSpec)

yline(y,LineSpec,labels)

yline(___,Name,Value)

yline(ax,___)

yl = yline(___)

说明

示例

yline(y) 在当前坐标区的一个或多个 y 坐标处创建一条水平线。例如，yline(2) 在 y=2 处创建一条线。

示例

yline(y,LineSpec) 指定线型、线条颜色或同时指定两者。例如，yline([12 20 33],'--b') 创建三条蓝色虚线。

示例

yline(y,LineSpec,labels) 为线条添加标签。

示例

yline(___,Name,Value) 使用一个或多个名称-值对组参量指定常量线属性。有关属性列表，请参阅 ConstantLine 属性。请在所有其他输入参量之后指定名称-值对组。

示例

yline(ax,___) 在指定的坐标区（而不是当前坐标区）中创建线条。要确定当前坐标区，请使用 gca。

示例

yl = yline(___) 返回一个 ConstantLine 对象或 ConstantLine 对象数组。使用 yl 修改或查询所创建的线条的属性。

示例

全部折叠

创建水平线

打开实时脚本

在 y = 2.5 处创建一条水平线。

yline(2.5);

添加标签

打开实时脚本

要创建一条具有标签的线条，还必须指定线型。默认线型是实线 '-'。

fplot(@(x) log(x));
xlim([0 15]);
ylim([0 4]);
yline(3,'-','Threshold');

创建多条带标签的线

打开实时脚本

定义一组 x 和 y 向量并对其绘图。然后在最大和最小绘制值的上方和下方用额外空间填充 y 轴。

x = 0:0.1:60;
y = 4.*cos(x)./(x+2);
plot(x,y)
ylim padded

找到 y 的最大值和最小值。在这些位置创建带标签 'Max' 和 'Min' 的水平线。

ymax = max(y);
ymin = min(y);
yline([ymax ymin],'--',{'Max','Min'})

指定线型和颜色

打开实时脚本

在 y = 4 处创建一条蓝色点划线。

yline(4,'-.b');

指定线型、粗细和标签对齐方式

打开实时脚本

创建一条具有标签和指定线宽的水平虚线。

x = -2:0.25:2;
[X,Y] = meshgrid(x);
Z = X.*exp(-X.^2-Y.^2);
contour(X,Y,Z,30)

yl = yline(0,'--','y = 0','LineWidth',3);

更改标签的水平对齐方式和线条的颜色。

yl.LabelHorizontalAlignment = 'center';
yl.Color = [.80 0 .40];

在特定的坐标区上添加行

打开实时脚本

调用 tiledlayout 函数以创建 1×2 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1 和 ax2。然后在每个坐标区中绘图。通过将 ax1 传递给 yline 函数，在第一个图中添加一条水平线。

tiledlayout(1,2)
ax1 = nexttile;
x = -pi/2:pi/60:pi/2;
y1 = tan(sin(x)) + cos(sin(x)); 
plot(ax1,x,y1)

ax2 = nexttile;
x = -pi/2:pi/60:pi/2;
y2 = tan(cos(x)) + exp(x);
plot(ax2,x,y2)

yline(ax1,1.0);

输入参数

全部折叠

`y` — y 坐标
标量 | 向量

y 坐标，指定为标量或包含数值、分类、日期时间或持续时间值的向量。y 的数据类型必须与 y 轴的数据类型匹配。

示例: yline(10) 在 y=10 处显示一条线。

示例: yline([13 20 33]) 在 y=13、y=20 和 y=33 处显示线条。

`LineSpec` — 线型和颜色
字符向量 | 字符串标量

线型和颜色，指定为包含字符和符号的字符向量或字符串标量。字符和符号可以按任何顺序出现。您可以指定线型和/或线条颜色。忽略 'o' 等标记符号。

示例: '--g' 表示绿色虚线。

线型	描述	表示的线条
`"-"`	实线
`"--"`	虚线
`":"`	点线
`"-."`	点划线

颜色名称	短名称	外观
`'red'`	`'r'`
`'green'`	`'g'`
`'blue'`	`'b'`
`'cyan'`	`'c'`
`'magenta'`	`'m'`
`'yellow'`	`'y'`
`'black'`	`'k'`
`'white'`	`'w'`

`ax` — 目标坐标区
当前坐标区 (默认) | `Axes` 对象

目标坐标区，指定为 Axes 对象。如果希望 yline 在当前坐标区以外的坐标区中绘图，请使用此参量。

`labels` — 行标签
`''` (默认) | 字符向量 | 字符串标量 | 字符向量元胞数组 | 字符串数组

行标签，指定为字符向量、字符向量元胞数组、字符串数组或数值数组。要创建一个多行标签，请使用字符串数组或字符向量元胞数组。

为一条线创建标签

指定一个字符向量或字符串标量来显示一行文本。要显示多行文本，请指定字符向量元胞数组或字符串数组。

表示形式如何指定 labels 示例

一行文本

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

表示形式	如何指定 `labels`	示例
一行文本	指定一个字符向量或字符串标量。	yline(12,'-','Sample')
多行文本	指定一个字符向量元胞数组或字符串数组。数组中的每个元素是不同行的文本。	yline(12,'-',{'Sample','x=12'})

yline(12,'-','Sample')

A horizontal line in an axes with a label

多行文本

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

yline(12,'-',{'Sample','x=12'})

A horizontal line in an axes with a label that has two lines of text

为多行创建标签

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

表示形式如何指定 labels 示例

一个共享文本标签

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

表示形式	如何指定 `labels`	示例
一个共享文本标签	指定一个字符向量或字符串标量。	yline([13 20 33],'-','Sample')
每行有不同标签	指定一个字符向量元胞数组或字符串数组。数组中的每个元素都是一个对应不同行的标签。`labels` 数组中的元素数必须与 `x` 的长度匹配。	label = {'Sample 1','Sample 2','Sample 3'}; yline([13 20 33],'-',label)
不同的标签，部分标签有多行	创建一个字符向量元胞数组或字符串数组。使用 `sprintf` 函数在文本中插入换行符 (`'\n'`)。	label = {'Sample 1',sprintf('Sample 2\nx=20'),'Sample 3'}; yline([13 20 33],'-',label)

yline([13 20 33],'-','Sample')

Three horizontal lines in an axes with matching labels

每行有不同标签

指定一个字符向量元胞数组或字符串数组。数组中的每个元素都是一个对应不同行的标签。labels 数组中的元素数必须与 x 的长度匹配。

label = {'Sample 1','Sample 2','Sample 3'};
yline([13 20 33],'-',label)

Three horizontal lines in an axes with different labels

不同的标签，部分标签有多行

创建一个字符向量元胞数组或字符串数组。使用 sprintf 函数在文本中插入换行符 ('\n')。

label = {'Sample 1',sprintf('Sample 2\nx=20'),'Sample 3'};
yline([13 20 33],'-',label)

Three horizontal lines in an axes with different labels. The label for the second line has two lines of text

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但参量对组的顺序无关紧要。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: yline(3,':','Median Price','LabelHorizontalAlignment','center') 将标签的水平对齐方式指定为 'center'。

注意

此处所列的属性只是一部分。有关完整列表，请参阅 ConstantLine 属性。

`Color` — 线条颜色
`[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 三元组	十六进制颜色代码	外观
`"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"`	不适用	不适用	不适用	无颜色

以下是 MATLAB^® 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组	十六进制颜色代码	外观
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`