barh
水平条形图
语法
说明
barh(___, 使用一个或多个名称-值对组参量指定条形图的属性。仅使用默认 Name,Value)'grouped' 或 'stacked' 样式的条形图支持设置条形属性。在所有其他输入参量之后指定名称-值对组参量。有关属性列表，请参阅 Bar 属性。
示例
创建一个包含四个值的向量。在一个条形图中显示这些值，每个水平条形对应一个值。
y = [10 20 30 41]; barh(y)
将 x 定义为一个包含三个年份值的矩阵。将 y 定义为包含四个城市的降雪数据的矩阵。在每年的组中显示四个条形序列。然后添加轴标签和图例。
x = [1980 1990 2000]; y = [40 50 63 52; 42 55 50 48; 30 20 44 40]; barh(x,y) xlabel('Snowfall') ylabel('Year') legend({'Springfield','Fairview','Bristol','Jamesville'})
自 R2023b 起
创建一个包含四个条形名称的字符串向量 x。创建一个包含条形长度的数值向量 y。然后创建一个 x 和 y 的条形图。
x = ["Spring" "Summer" "Autumn" "Winter"]; y = [1 2 3 4]; barh(x,y)
创建矩阵 y。然后在条形图中以 25 为基线值显示 y 值。小于 25 的值显示在基线的左侧。
y = [8 15 33; 30 35 40; 50 55 62];
barh(y,'BaseValue',25)
将 x 定义为一个包含三个年份值的向量。将 y 定义为包含负值和正值组合的矩阵。在堆叠水平条形图中显示值。
x = [1980 1990 2000];
y = [15 20 -5; 10 -17 21; -10 5 15];
barh(x,y,'stacked')
将 y 定义为包含四个值的向量，并在水平条形图中显示值。然后调用 yticklabels 函数来更改垂直轴上的刻度标签。
y = [10 20 30 41];
barh(y)
yticklabels({'April','May','June','July'})
指示条形图类别的一种方法是将 X 指定为分类数组。barh 函数使用经过排序的类别列表，因此条形的显示顺序可能与您预期的有所不同。要保留顺序，请调用 reordercats 函数。
将 X 定义为分类数组，并调用 reordercats 函数来指定条形的顺序。然后将 Y 定义为条形长度的向量，并显示条形图。
X = categorical({'Small','Medium','Large','Extra Large'});
X = reordercats(X,{'Small','Medium','Large','Extra Large'});
Y = [10 21 33 52];
barh(X,Y)
自 R2024b 起
创建一个包含两个数据序列的矩阵 vals。在水平条形图中显示数据，并指定输出参量。由于有两个序列，barh 返回包含两个 Bar 对象的向量。
x = [1 2 3]; vals = [2 3 6; 11 23 26]; b = barh(x,vals);
在第一个条形序列的末端显示存储在 YData 属性中的条形值。
b(1).Labels = b(1).YData;
然后以同样的方式对第二个条形序列添加标签。
b(2).Labels = b(2).YData;
作为使用 Labels 属性指定条形标签的替代方法，您可以使用 text 函数来创建标签，并使用 XEndPoints 和 YEndPoints 属性来定位它们。
创建一个包含两个数据序列的矩阵 vals。在水平条形图中显示数据，并指定输出参量。由于有两个序列，barh 返回包含两个 Bar 对象的向量。
x = [1 2 3]; vals = [2 3 6; 11 23 26]; b = barh(x,vals);
在第一个条形序列的末端显示条形值。通过获取第一个 Bar 对象的 XEndPoints 和 YEndPoints 属性，获取条形末端的坐标。由于水平条形图具有经过旋转的坐标区，因此在将 XEndPoints 和 YEndPoints 的值传递给 text 函数之前对它们进行切换。将填充值 0.3 添加到 YEndpoints 中，使文本不会紧挨条形的边。然后调用 text 函数以显示标签。
xtips1 = b(1).YEndPoints + 0.3; ytips1 = b(1).XEndPoints; labels1 = string(b(1).YData); text(xtips1,ytips1,labels1,'VerticalAlignment','middle')
接下来，按照相同的步骤，在第二个条形序列的末端显示值。
xtips2 = b(2).YEndPoints + 0.3; ytips2 = b(2).XEndPoints; labels2 = string(b(2).YData); text(xtips2,ytips2,labels2,'VerticalAlignment','middle')
创建数据并在水平条形图中显示数据，该条形图中条形的宽度为 0.4，颜色为红色。
y = [10 22 30 42];
width = 0.4;
barh(y,width,'red');
创建矩阵 y，其中每列为一个数据序列。然后在条形图中显示数据，指定在调用 barh 函数时的输出参量。在本例中，barh 返回包含三个 Bar 对象的向量。每个对象对应于一个不同序列。
y = [10 15 20; 30 35 40; 50 55 62]; b = barh(y);
将第二个条形序列改为绿色，并使用加粗的红边。
b(2).FaceColor = [.2 .6 .5]; b(2).EdgeColor = [.63 .08 .18]; b(2).LineWidth = 2;
创建数据，并使用使用默认的 'grouped' 样式和 'stacked' 样式在两个不同的条形图中显示数据。
x = [1980 1990 2000]; y = [8 15 25; 30 35 40; 50 55 62]; % Grouped tiledlayout(2,1); ax1 = nexttile; barh(ax1,x,y) title('Grouped Style') % Stacked ax2 = nexttile; barh(ax2,x,y,'stacked') title('Stacked Style')
输入参数
垂直轴坐标，指定为标量、向量、矩阵、字符串数组或字符向量元胞数组。x 的值不需要按顺序排列。
如果将 x 指定为字符串数组或字符向量元胞数组，则值必须唯一。MATLAB® 将值存储为分类数组，条形按指定的顺序显示。
下表描述一些常见的数据呈现方式。
| 表示形式 | 如何指定 X 和 Y | 示例 |
|---|---|---|
| 显示一个条形序列。 | 指定 |
x = [1980 1990 2000]; y = [10 20 30]; barh(x,y)
|
| 分组显示多个条形序列。 | 指定以下任意一种组合：
| x = [1980 1980 1980
1990 1990 1990];
y = [2 6 9
11 22 32];
barh(x,y)x = [1980 1990];
y = [2 6 9
11 22 32];
barh(x,y)
|
显示以一个 x 值为中心的一组条形。 | 指定 |
x = 1990; y = [10 20 30]; barh(x,y)
|
数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration | string (自 R2023b 起) | cell (自 R2023b 起)
条形长度，指定为标量、向量或矩阵。y 的大小取决于 x 的大小以及您要如何显示数据。下表说明了最常见的情况。
| 表示形式 | 如何指定 X 和 Y | 示例 |
|---|---|---|
| 显示一个条形序列。 | 指定 |
x = [1980 1990 2000]; y = [10 20 30]; barh(x,y)
|
| 分组显示多个条形序列。 | 指定以下任意一种组合：
| x = [1980 1980 1980
1990 1990 1990];
y = [2 6 9
11 22 32];
barh(x,y)x = [1980 1990];
y = [2 6 9
11 22 32];
barh(x,y)
|
显示以一个 x 值为中心的一组条形。 | 指定 |
x = 1990; y = [10 20 30]; barh(x,y)
|
数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | duration
条形宽度，指定为每个条形可用空间的一定比例。默认值 0.8 表示每个条形使用从上一条形到下一条形之间的空间的 80%，两端各有 10% 的空白空间。
如果宽度为 1，则组中的条形会紧挨在一起。
示例: barh([1 2 3],0.5) 创建使用 50% 可用空间的条形。
分组样式，使用下列值之一指定。
条形颜色，指定为下表中的选项之一。
| 颜色名称 | 短名称 | 外观 |
|---|---|---|
'red' | 'r' |
|
'green' | 'g' |
|
'blue' | 'b' |
|
'cyan' | 'c' |
|
'magenta' | 'm' |
|
'yellow' | 'y' |
|
'black' | 'k' |
|
'white' | 'w' |
|
目标坐标区，指定为 Axes 对象。如果未指定坐标区，则条形图显示在当前坐标区中。
名称-值参数
以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。
在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。
示例: barh([10 20 30],'EdgeColor','g') 将围绕条形的轮廓指定为绿色。
轮廓颜色，指定为 'flat'、RGB 三元组、十六进制颜色代码、颜色名称或短名称。如果有 150 个条形或更少，则默认值为 [0 0 0]，对应于黑色。如果相邻条形超过 150 个，则默认值为 'none'。
从 R2017b 开始，'flat' 选项使用 CData 值对边进行着色。在以前的版本中，'flat' 选项使用颜色图中的颜色对边进行着色。
对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。
RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]范围内，例如[0.4 0.6 0.7]。十六进制颜色代码是字符串标量或字符向量，以井号 (
#) 开头，后跟三个或六个十六进制数字，范围可以是0到F。这些值不区分大小写。因此，颜色代码"#FF8800"与"#ff8800"、"#F80"与"#f80"是等效的。
此外，还可以按名称指定一些常见的颜色。下表列出了一些命名颜色选项、其等效 RGB 三元组及十六进制颜色代码。
| 颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
"none" | 不适用 | 不适用 | 不适用 | 无颜色 |
下表列出了浅色和深色主题中绘图的默认调色板。
| 调色板 | 调色板颜色 |
|---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。
在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。
示例: b = bar(1:10,'EdgeColor','red')
示例: b.EdgeColor = [0 0.5 0.5];
示例: b.EdgeColor = 'flat';
示例: b.EdgeColor = '#D2F9A7';
填充颜色，指定为 'flat'、RGB 三元组、十六进制颜色代码、颜色名称或短名称。'flat' 选项使用 Bar 对象的 CData 属性值对面进行着色。
对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。
RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]范围内，例如[0.4 0.6 0.7]。十六进制颜色代码是字符串标量或字符向量，以井号 (
#) 开头，后跟三个或六个十六进制数字，范围可以是0到F。这些值不区分大小写。因此，颜色代码"#FF8800"与"#ff8800"、"#F80"与"#f80"是等效的。
此外，还可以按名称指定一些常见的颜色。下表列出了一些命名颜色选项、其等效 RGB 三元组及十六进制颜色代码。
| 颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
"none" | 不适用 | 不适用 | 不适用 | 无颜色 |
下表列出了浅色和深色主题中绘图的默认调色板。
| 调色板 | 调色板颜色 |
|---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。
在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。
从 R2017b 开始，默认值是来自坐标区的 ColorOrder 属性的一个 RGB 三元组。在以前的版本中，默认值为 'flat'，且颜色基于颜色图。
示例: b = bar(1:10,'FaceColor','red')
示例: b.FaceColor = [0 0.5 0.5];
示例: b.FaceColor = 'flat';
示例: b.FaceColor = '#D2F9A7';
