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

errorbar

含误差条的线图

说明

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)

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

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

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

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

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

通过将 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 为向量,则 errorbar 绘制一个线条。

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

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

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

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

示例: x = 0:10:100;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • 'vertical' - 垂直误差条

  • 'horizontal' - 水平误差条

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

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

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

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

线型说明
-实线(默认)
--虚线
:点线
-.点划线
标记说明
o圆圈
+加号
*星号
.
x叉号
s方形
d菱形
^上三角
v下三角
>右三角
<左三角
p五角形
h六角形
颜色说明

y

黄色

m

品红色

c

青蓝色

r

红色

g

绿色

b

蓝色

w

白色

k

黑色

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

名称-值对组参数

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

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

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

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

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

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

扩展功能

另请参阅

函数

属性

在 R2006a 之前推出