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