errorbar
含误差条的线图

语法
说明
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)
绘制不同长度的垂直误差条
在每个数据点处创建带误差条的线图。改变误差条的长度。
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')
绘制带误差条的日期时间值
创建一个带误差条的日期时间值图,以持续时间单位显示。
x = 1:13; y = datetime(2018,5,1,1:13,0,0); err = hours(rand(13,1)); errorbar(x,y,err)
向每个数据点添加彩色标记
创建带误差条的线图。在每个数据点处显示标记。使用名称-值对组参数控制标记的外观。使用 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: [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;
输入参数
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)。
版本历史记录
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)