Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

errorbar

含误差条的线图

  • Line plot with error bars

说明

errorbar(y,err) 创建 y 中数据的线图,并在每个数据点处绘制一个垂直误差条。err 中的值确定数据点上方和下方的每个误差条的长度,因此,总误差条长度是 err 值的两倍。

示例

errorbar(x,y,err) 绘制 yx 的图,并在每个数据点处绘制一个垂直误差条。

errorbar(x,y,neg,pos) 在每个数据点处绘制一个垂直误差条,其中 neg 确定数据点下方的长度,pos 确定数据点上方的长度。

示例

errorbar(___,ornt) 设置误差条的方向。为水平误差条指定 ornt'horizontal',或者为水平和垂直误差条指定 'both'ornt 的默认值为 'vertical',这将绘制垂直误差条。在前面的任何输入参数组合之后使用此选项。

示例

errorbar(x,y,yneg,ypos,xneg,xpos) 绘制 yx 的图,并同时绘制水平和垂直误差条。ynegypos 输入分别设置垂直误差条下部和上部的长度。xnegxpos 输入分别设置水平误差条左侧和右侧的长度。

示例

errorbar(___,LineSpec) 设置线型、标记符号和颜色。例如,'--ro' 绘制带圆形标记的红色虚线。线型仅影响线,而不影响误差条。

示例

errorbar(___,Name,Value) 使用一个或多个名称-值对组参数修改线和误差条的外观。例如,'CapSize',10 将每个误差条末端的端盖长度设置为 10 磅。

errorbar(ax,___) 在由 ax 指定的坐标区(而不是当前坐标区)中创建绘图。指定坐标区作为第一个输入参数。

示例

y 为向量时,e = errorbar(___) 返回一个 ErrorBar 对象。如果 y 是矩阵,它将为 y 中的每一列返回一个 ErrorBar 对象。可在创建特定的 ErrorBar 对象后使用 e 修改其属性。有关属性列表,请参阅 ErrorBar 属性

示例

全部折叠

创建向量 xy。绘制 yx 的图。在每个数据点处,显示长度相等的垂直误差条。

x = 1:10:100;
y = [20 30 45 40 60 65 80 75 95 90];
err = 8*ones(size(y));
errorbar(x,y,err)

Figure contains an axes object. The axes object contains an object of type errorbar.

在每个数据点处创建带误差条的线图。改变误差条的长度。

x = 1:10:100;
y = [20 30 45 40 60 65 80 75 95 90]; 
err = [5 8 2 9 3 3 8 3 9 3];
errorbar(x,y,err)

Figure contains an axes object. The axes object contains an object of type errorbar.

在每个数据点处创建带水平误差条的线图。

x = 1:10:100;
y = [20 30 45 40 60 65 80 75 95 90];
err = [1 3 5 3 5 3 6 4 3 3];
errorbar(x,y,err,'horizontal')

Figure contains an axes object. The axes object contains an object of type errorbar.

在每个数据点处创建带垂直和水平误差条的线图。

x = 1:10:100;
y = [20 30 45 40 60 65 80 75 95 90];
err = [4 3 5 3 5 3 6 4 3 3];
errorbar(x,y,err,'both')

Figure contains an axes object. The axes object contains an object of type errorbar.

绘制向量 yx 的图。在每个数据点处显示一个圆形标记以及垂直和水平误差条。通过省略 linespec 输入参数的线型选项,不显示连接数据点的线。

x = 1:10:100;
y = [20 30 45 40 60 65 80 75 95 90];
err = [4 3 5 3 5 3 6 4 3 3];
errorbar(x,y,err,'both','o')

Figure contains an axes object. The axes object contains an object of type errorbar.

在每个数据点处显示垂直和水平误差条。使用 ynegypos 输入参数选项分别控制垂直误差条下部和上部的长度。使用 xnegxpos 输入参数选项分别控制水平误差条左侧和右侧的长度。

x = 1:10:100;
y = [20 30 45 40 60 65 80 75 95 90];
yneg = [1 3 5 3 5 3 6 4 3 3];
ypos = [2 5 3 5 2 5 2 2 5 5];
xneg = [1 3 5 3 5 3 6 4 3 3];
xpos = [2 5 3 5 2 5 2 2 5 5];
errorbar(x,y,yneg,ypos,xneg,xpos,'o')

Figure contains an axes object. The axes object contains an object of type errorbar.

创建一个带误差条的日期时间值图,以持续时间单位显示。

x = 1:13;
y = datetime(2018,5,1,1:13,0,0);
err = hours(rand(13,1));
errorbar(x,y,err)

Figure contains an axes object. The axes object contains an object of type errorbar.

创建带误差条的线图。在每个数据点处显示标记。使用名称-值对组参数控制标记的外观。使用 MarkerSize 以磅为单位指定标记大小。使用 MarkerEdgeColorMarkerFaceColor 分别指定标记轮廓和内部颜色。将颜色设置为颜色名称字符向量(例如 'red')或 RGB 三元组。

x = linspace(0,10,15);
y = sin(x/2);
err = 0.3*ones(size(y));
errorbar(x,y,err,'-s','MarkerSize',10,...
    'MarkerEdgeColor','red','MarkerFaceColor','red')

Figure contains an axes object. The axes object contains an object of type errorbar.

通过将 CapSize 属性设置为以磅为单位的正值,控制每个误差条末端的端盖大小。

x = linspace(0,2,15);
y = exp(x);
err = 0.3*ones(size(y));
errorbar(x,y,err,'CapSize',18)

Figure contains an axes object. The axes object contains an object of type errorbar.

创建带误差条的线图。将误差条对象赋给变量 e

x = linspace(0,10,10);
y = sin(x/2);
err = 0.3*ones(size(y));
e = errorbar(x,y,err)

Figure contains an axes object. The axes object contains an object of type errorbar.

e = 
  ErrorBar with properties:

             Color: [0 0.4470 0.7410]
         LineStyle: '-'
         LineWidth: 0.5000
            Marker: 'none'
             XData: [0 1.1111 2.2222 3.3333 4.4444 5.5556 6.6667 7.7778 ... ]
             YData: [0 0.5274 0.8962 0.9954 0.7952 0.3558 -0.1906 ... ]
    XNegativeDelta: [1x0 double]
    XPositiveDelta: [1x0 double]
    YNegativeDelta: [0.3000 0.3000 0.3000 0.3000 0.3000 0.3000 0.3000 ... ]
    YPositiveDelta: [0.3000 0.3000 0.3000 0.3000 0.3000 0.3000 0.3000 ... ]

  Show all properties

在创建误差条对象后,使用 e 访问其属性。

e.Marker = '*';
e.MarkerSize = 10;
e.Color = 'red';
e.CapSize = 15;

Figure contains an axes object. The axes object contains an object of type errorbar.

输入参数

全部折叠

y 值,指定为向量或矩阵。

  • 如果 y 为向量,则 errorbar 绘制一个线条。

  • 如果 y 为矩阵,则 errorbar 将为 y 中的每一列绘制一个单独的线条。

示例: y = [4 3 5 2 2 4];

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical | datetime | duration

x 值,指定为向量或矩阵。x 的大小必须与 y 相同。

示例: x = 0:10:100;

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical | datetime | duration

对称误差条的误差条长度,指定为向量或矩阵。err 的大小必须与 y 相同。如果您不希望在特定数据点处绘制误差条,则将长度指定为 NaN

误差条长度的数据类型必须与对应的绘图数据兼容。例如,如果绘制 datetime 值,这些值的误差条必须为 duration 值。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration

负方向上的误差条长度,指定为与 y 具有相同大小的向量或矩阵,或指定为空数组 []

  • 对于垂直误差条,neg 设置数据点下方的误差条长度。

  • 对于水平误差条,neg 设置数据点左侧的误差条长度。

如果您不希望在特定数据点处绘制误差条的下部,则将长度指定为 NaN。如果您不希望在任何数据点处绘制误差条的下部,则将 neg 设置为空数组。

误差条长度的数据类型必须与对应的绘图数据兼容。例如,如果绘制 datetime 值,这些值的误差条必须为 duration 值。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration

正方向上的误差条长度,指定为与 y 具有相同大小的向量或矩阵,或指定为空数组 []

  • 对于垂直误差条,pos 设置数据点上方的误差条长度。

  • 对于水平误差条,pos 设置数据点右侧的误差条长度。

如果您不希望在特定数据点处绘制误差条的上部,则将长度指定为 NaN。如果您不希望在任何数据点处绘制误差条的上部,则将 pos 设置为空数组。

误差条长度的数据类型必须与对应的绘图数据兼容。例如,如果绘制 datetime 值,这些值的误差条必须为 duration 值。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration

数据点下方的垂直误差条长度,指定为与 y 具有相同大小的向量或矩阵,或指定为空数组 []

如果您不希望在特定数据点处绘制误差条的下部,则将值指定为 NaN。如果您不希望在任何数据点处绘制误差条的下部,则将 yneg 设置为空数组。

误差条长度的数据类型必须与对应的绘图数据兼容。例如,如果绘制 datetime 值,这些值的误差条必须为 duration 值。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration

数据点上方的垂直误差条长度,指定为与 y 具有相同大小的向量或矩阵,或指定为空数组 []

如果您不希望在特定数据点处绘制误差条的上部,则将长度指定为 NaN。如果您不希望在任何数据点处绘制误差条的上部,则将 ypos 设置为空数组。

误差条长度的数据类型必须与对应的绘图数据兼容。例如,如果绘制 datetime 值,这些值的误差条必须为 duration 值。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration

数据点左侧的水平误差条长度,指定为与 y 具有相同大小的向量或矩阵,或指定为空数组 []

如果您不希望在特定数据点处绘制误差条的左侧,则将长度指定为 NaN。如果您不希望在任何数据点处绘制误差条的左侧,则将 xneg 设置为空数组。

误差条长度的数据类型必须与对应的绘图数据兼容。例如,如果绘制 datetime 值,这些值的误差条必须为 duration 值。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration

数据点右侧的水平误差条长度,指定为与 y 具有相同大小的向量或矩阵,或指定为空数组 []

如果您不希望在特定数据点处绘制误差条的右侧,则将长度指定为 NaN。如果您不希望在任何数据点处绘制误差条的右侧,则将 xpos 设置为空数组。

误差条长度的数据类型必须与对应的绘图数据兼容。例如,如果绘制 datetime 值,这些值的误差条必须为 duration 值。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration

误差条方向,指定为下列值之一:

  • 'vertical' - 垂直误差条

  • 'horizontal' - 水平误差条

  • 'both' - 水平和垂直误差条

示例: errorbar(x,y,err,'horizontal')

线型、标记和颜色,指定为包含符号的字符向量或字符串。符号可以按任意顺序显示。您不需要同时指定所有三个特征(线型、标记和颜色)。例如,如果忽略线型,只指定标记,则绘图只显示标记,不显示线条。

示例: '--or' 是带有圆形标记的红色虚线

线型说明表示的线条
'-'实线

Sample of solid line

'--'虚线

Sample of dashed line

':'点线

Sample of dotted line

'-.'点划线

Sample of dash-dotted line, with alternating dashes and dots

标记说明生成的标记
'o'圆圈

Sample of circle marker

'+'加号

Sample of plus sign marker

'*'星号

Sample of asterisk marker

'.'

Sample of point marker

'x'叉号

Sample of cross marker

'_'水平线条

Sample of horizontal line marker

'|'垂直线条

Sample of vertical line marker

's'方形

Sample of square marker

'd'菱形

Sample of diamond line marker

'^'上三角

Sample of upward-pointing triangle marker

'v'下三角

Sample of downward-pointing triangle marker

'>'右三角

Sample of right-pointing triangle marker

'<'左三角

Sample of left-pointing triangle marker

'p'五角形

Sample of pentagram marker

'h'六角形

Sample of hexagram marker

颜色名称短名称RGB 三元组外观
'red''r'[1 0 0]

Sample of the color red

'green''g'[0 1 0]

Sample of the color green

'blue''b'[0 0 1]

Sample of the color blue

'cyan' 'c'[0 1 1]

Sample of the color cyan

'magenta''m'[1 0 1]

Sample of the color magenta

'yellow''y'[1 1 0]

Sample of the color yellow

'black''k'[0 0 0]

Sample of the color black

'white''w'[1 1 1]

Sample of the color white

坐标区对象。如果未指定坐标区,则 errorbar 在当前坐标区中绘图。

名称-值参数

示例: errorbar(y,err,'LineWidth',2) 指定 2 磅的线宽。

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

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

误差条末端的端盖长度,指定为以磅为单位的正值。

示例: errorbar(x,y,err,'CapSize',10)

线宽,指定为以磅为单位的正值,其中 1 磅 = 1/72 英寸。如果该线条具有标记,则线条宽度也会影响标记边。

线宽不能小于像素的宽度。如果将线宽设置为小于系统上像素宽度的值,则线条显示为一个像素的宽度。

扩展功能

版本历史记录

在 R2006a 之前推出

另请参阅

函数

属性