本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

yline

具有常量 y 值的水平线

说明

示例

yline(yvalue) 在当前坐标区中的指定 y 值处创建一条常量水平线。例如,yline(6)y = 6 处创建一条线。

示例

yline(yvalue,LineSpec) 指定线型、线条颜色或同时指定两者。例如,':' 创建虚线,'m' 创建洋红色线,':m' 创建洋红色虚线。

示例

yline(yvalue,LineSpec,label) 将指定的标签添加到该线。

示例

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

示例

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

示例

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

示例

全部折叠

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

yline(2.5);

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

yline(4,'-.b');

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

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

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

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];

在一个 1×2 网格中创建若干子图,并在每个子图中绘制数据。然后,在第一个子图上添加一条水平线。

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

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

yline(ax1,1.0);

输入参数

全部折叠

y 轴上水平线的位置,指定为标量。您可以将 yvalue 指定为数值、分类、datetime 或持续时间值。但是,您指定的值的类型必须与沿 y 轴的值的数据类型匹配。

示例: yline(8.45) 在 y = 8.45 处绘制线条。

示例: yline(C(2)) 在数组中第二个元素的值处绘制线条。

示例: yline(datetime('today')) 在当前日期和时间处绘制线条。

线型和颜色,指定为包含符号的字符向量或字符串标量。字符和符号可以按任意顺序显示。您可以指定线型、线条颜色或同时指定两者。您不能指定标记符号。

示例: '--' 表示虚线。

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

线型说明
'-'实线(默认)
'-–'虚线
':'点线
'-.'点划线
颜色说明
'y'黄色
'm'品红色
'c'青蓝色
'r'红色
'g'绿色
'b'蓝色
'w'白色
'k'黑色

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

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

示例: yline(55,'-.','Target Sales')

示例: yline(75,'-',["Average","Student Score"])

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

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

注意

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

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

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

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 '#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'

示例: 'g'

示例: [0.6 0.2 0.5]

示例: '#D2F9A7'

线宽,指定为以磅为单位的正值。

图例标签,指定为字符向量或字符串标量。只有调用 legend 命令之后,才会显示图例。如果未指定文本,则 legend 使用 'dataN' 形式设置标签。

标签相对于线的水平对齐,指定为下表中的选项之一。

选项说明示例
'right'线的右侧

'left'线的左侧

'center'线的中心

标签相对于线的垂直对齐,指定为下表中的选项之一。

选项说明示例
'top'线的顶部。

'middle'线的中间。标签将线分段。

'bottom'线的底部。

标签方向,指定为 'aligned''horizontal'。下表中显示了示例。

方向说明示例
'aligned'标签与指定线的方向相同。

'horizontal'无论线的方向如何,标签始终为水平方向。

算法

在坐标区的三维视图中,常量线出现在 z 坐标轴范围中点处的 x-y 平面中。如果坐标区旋转,则常量线会随之旋转。

另请参阅

函数

属性

在 R2018b 中推出