帮助中心帮助中心

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

errorbar

含误差条的线图

语法

errorbar(y,err)

errorbar(x,y,err)

errorbar(x,y,neg,pos)

errorbar(___,ornt)

errorbar(x,y,yneg,ypos,xneg,xpos)

errorbar(___,LineSpec)

errorbar(___,Name,Value)

errorbar(ax,___)

e = errorbar(___)

说明

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

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

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

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

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

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

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

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

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

示例

绘制长度相等的垂直误差条

打开实时脚本

创建向量 x 和 y。绘制 y 对 x 的图。在每个数据点处，显示长度相等的垂直误差条。

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.

绘制不带线条的误差条

打开实时脚本

绘制向量 y 对 x 的图。在每个数据点处显示一个圆形标记以及垂直和水平误差条。通过省略 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.

控制所有方向上的误差条长度

打开实时脚本

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

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 以磅为单位指定标记大小。使用 MarkerEdgeColor 和 MarkerFaceColor 分别指定标记轮廓和内部颜色。将颜色设置为颜色名称字符向量（例如 '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 值
向量 | 矩阵

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 值
向量 | 矩阵

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

示例： x = 0:10:100;

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

`err` - 对称误差条的误差条长度
向量 | 矩阵

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

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

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

`neg` - 负方向上的误差条长度
向量 | 矩阵 | `[]`

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

对于垂直误差条，neg 设置数据点下方的误差条长度。
对于水平误差条，neg 设置数据点左侧的误差条长度。

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

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

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

`pos` - 正方向上的误差条长度
向量 | 矩阵 | `[]`

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

对于垂直误差条，pos 设置数据点上方的误差条长度。
对于水平误差条，pos 设置数据点右侧的误差条长度。

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

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

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

`yneg` - 数据点下方的垂直误差条长度
向量 | 矩阵 | `[]`

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

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

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

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

`ypos` - 数据点上方的垂直误差条长度
向量 | 矩阵 | `[]`

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

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

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

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

`xneg` - 数据点左侧的水平误差条长度
向量 | 矩阵 | `[]`

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

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

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

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

`xpos` - 数据点右侧的水平误差条长度
向量 | 矩阵 | `[]`

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

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

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

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

`ornt` - 误差条方向
`'vertical'` （默认） | `'horizontal'` | `'both'`

误差条方向，指定为下列值之一：

'vertical' - 垂直误差条
'horizontal' - 水平误差条
'both' - 水平和垂直误差条

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

`LineSpec` - 线型、标记和颜色
字符向量 | 字符串

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

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

线型	说明	表示的线条
`'-'`	实线
`'--'`	虚线
`':'`	点线
`'-.'`	点划线

标记	说明	生成的标记
`'o'`	圆圈
`'+'`	加号
`'*'`	星号
`'.'`	点
`'x'`	叉号
`'_'`	水平线条
`'\|'`	垂直线条
`'s'`	方形
`'d'`	菱形
`'^'`	上三角
`'v'`	下三角
`'>'`	右三角
`'<'`	左三角
`'p'`	五角形
`'h'`	六角形

颜色名称	短名称	RGB 三元组	外观
`'red'`	`'r'`	`[1 0 0]`
`'green'`	`'g'`	`[0 1 0]`
`'blue'`	`'b'`	`[0 0 1]`
`'cyan'`	`'c'`	`[0 1 1]`
`'magenta'`	`'m'`	`[1 0 1]`
`'yellow'`	`'y'`	`[1 1 0]`
`'black'`	`'k'`	`[0 0 0]`
`'white'`	`'w'`	`[1 1 1]`

`ax` - 坐标区对象
当前坐标区（默认） | 坐标区对象

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

名称-值参数

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

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

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

`CapSize` - 误差条末端的端盖长度
`6` （默认） | 以磅为单位的正值

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

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

`LineWidth` - 线条宽度
`0.5` （默认） | 正值

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

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

扩展功能

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

用法说明和限制：

此函数接受 GPU 数组，但不在 GPU 上运行。

有关详细信息，请参阅Run MATLAB Functions on a GPU (Parallel Computing Toolbox)。

分布式数组
使用 Parallel Computing Toolbox™ 在群集的组合内存中对大型数组进行分区。

用法说明和限制：

此函数在分布式数组上运行，但在客户端 MATLAB^® 中执行。

有关详细信息，请参阅Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox)。

版本历史记录

在 R2006a 之前推出

另请参阅

函数

corrcoef | std | plot | bar

属性

ErrorBar 属性