当 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)

绘制不同长度的垂直误差条

打开实时脚本

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

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)

绘制水平误差条

打开实时脚本

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

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')

绘制垂直和水平误差条

打开实时脚本

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

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')

绘制不带线条的误差条

打开实时脚本

绘制向量 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')

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

打开实时脚本

在每个数据点处显示垂直和水平误差条。使用 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')

向每个数据点添加彩色标记

打开实时脚本

创建带误差条的线图。在每个数据点处显示标记。使用名称-值对组参数控制标记的外观。使用 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')

控制误差条端盖大小

打开实时脚本

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

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

创建后修改误差条

打开实时脚本

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

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

e = 
  ErrorBar with properties:

             Color: [0 0.4470 0.7410]
         LineStyle: '-'
         LineWidth: 0.5000
            Marker: 'none'
             XData: [1x10 double]
             YData: [1x10 double]
    XNegativeDelta: [1x0 double]
    XPositiveDelta: [1x0 double]
    YNegativeDelta: [1x10 double]
    YPositiveDelta: [1x10 double]

  Show all properties

在创建误差条对象后，使用 e 访问其属性。从 R2014b 开始，您可以使用圆点表示法设置属性。如果您使用的是早期版本，请改用 set 函数。

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

输入参数

全部折叠

`y` - y 值
向量 | 矩阵

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

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

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

`x` - x 值
向量 | 矩阵

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

示例： x = 0:10:100;

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

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

示例： err = [.4 .3 .5 .2 .4 .5];

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

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

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

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

示例： neg = [.4 .3 .5 .2 .4 .5];

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

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

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

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

示例： pos = [.4 .3 .5 .2 .4 .5];

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

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

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

示例： yneg = [.4 .3 .5 .2 .4 .5];

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

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

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

示例： ypos = [.4 .3 .5 .2 .4 .5];

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

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

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

示例： xneg = [.4 .3 .5 .2 .4 .5];

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

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

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

示例： xpos = [.4 .3 .5 .2 .4 .5];

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

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

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

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

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

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

示例： errorbar(x,y,err,'--or') 在数据点处绘制带圆形标记的红色虚线和红色误差条。

线型	说明
`-`	实线（默认）
`--`	虚线
`:`	点线
`-.`	点划线

标记	说明
`o`	圆圈
`+`	加号
`*`	星号
`.`	点
`x`	叉号
`s`	方形
`d`	菱形
`^`	上三角
`v`	下三角
`>`	右三角
`<`	左三角
`p`	五角形
`h`	六角形

颜色	说明
`y`	黄色
`m`	品红色
`c`	青蓝色
`r`	红色
`g`	绿色
`b`	蓝色
`w`	白色
`k`	黑色

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

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

名称-值对组参数

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

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

此处所列的属性只是一部分。有关完整列表，请参阅 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)。

errorbar

语法

说明

示例

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

绘制不同长度的垂直误差条

绘制水平误差条

绘制垂直和水平误差条

绘制不带线条的误差条

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

向每个数据点添加彩色标记

控制误差条端盖大小

创建后修改误差条

输入参数

`y` - y 值
向量 | 矩阵

`x` - x 值
向量 | 矩阵

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

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

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

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

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

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

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

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

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

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

名称-值对组参数

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

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

扩展功能

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

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

另请参阅

函数

属性

在 R2006a 之前推出

MATLAB 文档

支持

Introducing Deep Learning with MATLAB

errorbar

语法

说明

示例

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

绘制不同长度的垂直误差条

绘制水平误差条

绘制垂直和水平误差条

绘制不带线条的误差条

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

向每个数据点添加彩色标记

控制误差条端盖大小

创建后修改误差条

输入参数

y - y 值 向量 | 矩阵

x - x 值 向量 | 矩阵

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

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

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

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

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

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

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

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

linespec - 线型、标记符号和颜色 字符向量 | 字符串

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

名称-值对组参数

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

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

扩展功能

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

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

另请参阅

函数

属性

在 R2006a 之前推出

MATLAB 文档

支持

Introducing Deep Learning with MATLAB

WeChat

`y` - y 值
向量 | 矩阵

`x` - x 值
向量 | 矩阵

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

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

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

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

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

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

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

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

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

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

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

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

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

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