bar3
三维条形图
说明
bar3(___, 设置沿 x 和 y 轴的条形宽度并控制组中各个条形的间隔。默认情况下，width)width 为 0.8，条形之间有细小间隔。如果 width 为 1，组内的条形将紧挨在一起。
b = bar3(___)Surface 对象。如果 z 是向量，则 bar3 将创建一个 Surface 对象。如果 z 是矩阵，则 bar3 为每个序列返回一个 Surface 对象。显示条形图后，使用 b 设置条形的属性。有关属性列表，请参阅 Surface 属性。
示例
将 z 指定为包含五个值的向量。将这些值绘制成一个三维条形序列，每个条形的高度对应于 z 中的一个值，其 y 轴位置对应于该值的索引。
z = [50 40 30 20 10]; bar3(z);
将 z 指定为一个矩阵。创建一个 z 的三维条形图，每个序列对应于 z 中的一列。
z = [1 4 7; 2 5 8; 3 6 9; 4 7 10]; bar3(z)
将 y 指定为由 z 中条形的 y 轴位置组成的向量。在指定的 y 轴位置处绘制条形。
y = [1950 1960 1970 1980 1990]; z = [16 8 4 2 1]; bar3(y,z)
将 z 指定为包含三个序列的矩阵。使用 'grouped' 样式将每行的数据分组到一起绘制 z。要消除同一组的条形之间的间距，请将 width 设置为 1。
z = [70 50 33 10; 75 55 35 15; 80 60 40 20];
bar3(z,1,'grouped')
创建一组值范围从 0 到 的 y 坐标。将 y 值的正弦函数绘制成一个三维条形图。使用颜色设定 'r' 将条形设置为红色。
y = 0:pi/16:pi;
z = [sin(y')/4 sin(y')/2 sin(y')];
bar3(y,z,1,'r')
用条形样式 'stacked' 和条形宽度 0.5 绘制数据矩阵 z。将返回的 Surface 对象存储为 b。在本例中，b 包含 4 个元素，其中每个元素对应 z 中的一列。
请注意，bar3 根据默认颜色图为每个序列着色。
z = [19 30 21 30; 40 16 32 12];
b = bar3(z,0.5,'stacked');
通过在 b 中设置对应对象的 FaceColor，自定义每个序列的颜色。
b(1).FaceColor = 'k'; b(2).FaceColor = 'white'; b(3).FaceColor = [.5 .7 .8]; b(4).FaceColor = [.9 .7 .8];
您可以使用 tiledlayout 和 nexttile 函数显示分块图。调用 tiledlayout 函数以创建 1×2 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1 和 ax2。通过将坐标区对象指定为 bar3 的第一个参量，在坐标区中创建单独的线图。
在左侧坐标区中显示一个堆叠三维条形图。在右侧坐标区中显示相同数据的一个分组条形图。
tiledlayout(1,2) z = [64 56 48; 49 42 35; 36 30 24]; % Left bar graph ax1 = nexttile; bar3(ax1,z,0.5,'stacked') % Right bar graph ax2 = nexttile; bar3(ax2,z,1,'grouped')
输入参数
z 坐标，指定为向量或矩阵。z 的维度确定函数显示数据的方式。下表说明了最常见的情况。
| 表示形式 | 如何指定 Y 和 Z | 示例 | 结果 |
|---|---|---|---|
| 显示一个条形序列。 |
| 定义向量 y = [1 2 3 4]; z = [10 20 30 40]; bar3(y,z) 或者，仅指定 bar3(z) |
|
| 显示沿 x 轴堆叠的多个条形序列。 |
| 定义向量 y = [1 2 3 4];
z = [1 5 9;
2 6 10;
3 7 11;
4 8 12];
bar3(y,z)或者，仅指定 bar3(z) |
|
数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | duration
y 坐标，指定为向量。y 的值不需要按顺序排列，但 y 的大小取决于 z 的大小以及您要如何显示数据。下表说明了最常见的情况。
| 表示形式 | 如何指定 Y 和 Z | 示例 | 结果 |
|---|---|---|---|
| 显示一个条形序列。 |
| 定义向量 y = [1 2 3 4]; z = [10 20 30 40]; bar3(y,z) 或者，仅指定 bar3(z) |
|
| 显示沿 x 轴堆叠的多个条形序列。 |
| 定义向量 y = [1 2 3 4];
z = [1 5 9;
2 6 10;
3 7 11;
4 8 12];
bar3(y,z)或者，仅指定 bar3(z) |
|
数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration
条形宽度，指定为表示可用于每个条形的总空间的一部分的标量。默认值 0.8 表示条形宽度是从上一条形到下一条形之间的空间的 80%，两端各占该空间的 10%。如果宽度为 1，则组中的条形紧挨在一起。
示例: bar3([1 2 3],0.5) 创建使用 50% 可用空间的条形。
数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
分组样式，指定为 'detached'、'grouped' 或 'stacked'。分组样式确定多个条形序列相对于彼此的显示方式。如果 z 是向量，则样式不影响图外观。
下表显示每个分组样式选项的效果。
| 分组样式 | 结果 | 示例 |
|---|---|---|
| 在对应的 x 和 y 值位置显示每个条形。 |
|
| 将每组显示为以对应的 y 值为中心的相邻条形。 |
|
| 将每组显示为一个多色条形。条形的长度是组中各元素之和。 |
|
条形颜色，指定为下表中的选项之一。
| 颜色名称 | 短名称 | 外观 |
|---|---|---|
'red' | 'r' |
|
'green' | 'g' |
|
'blue' | 'b' |
|
'cyan' | 'c' |
|
'magenta' | 'm' |
|
'yellow' | 'y' |
|
'black' | 'k' |
|
'white' | 'w' |
|
坐标区对象。如果您不指定坐标区，则 bar3 使用条形图的当前坐标区。
输出参量
详细信息
一个条形序列由对应于 z 中一个特定列的所有条形组成。bar3 函数显示沿 x 轴不同位置的每个序列。默认情况下，每个序列均为不同颜色。
在下图中，第一个序列突出显示。
一个组由一个特定 y 位置上的所有条形组成。
在下图中，第三个组突出显示。
提示
可以通过更改返回的
Surface对象的属性来修改绘制的条形。有关Surface属性列表，请参阅 Surface 属性。
