MATLAB Function Reference

bar, barh

長條圖

Syntax

bar(Y)
bar(x,Y)
bar(...,width)
bar(...,'style')
bar(...,LineSpec)
h = bar(...)

barh(...)
h = barh(...)

Description

長條圖可將向量或矩陣的值用垂直長條或水平長條表現出來。

bar(Y) 將Y中的每一元素繪製一長條，如果Y 是一矩陣，bar 將矩陣中每一列元素產生的長條(bar)聚集(group)起來，當Y 是一向量時，x軸的範圍大小由 1 到 length(Y)，當Y 是一矩陣時，範圍由1到size(Y,1)，其中size(Y,1) 表示矩陣的橫列數。

bar(x,Y) 繪製Y中每個元素的長條，且由x來指定長條的位置，x是一個單調遞增的向量，用來定義垂直長條在x軸上的間隔距離， 如果Y 是一矩陣， bar 將 Y中同一列的元素聚集起來在相對於x中元素的位置。

bar(...,width) 設定長條間的寬度且控制同一群組內部長條的分隔距離。當width 為default 時,其值是預設成0.8，所以若你不想指定x的值時,群組中的長條間距將會很小，若width設成 1，則在同一群組間的長條沒有間隔距離。

bar(...,'style') 指定長條的種類，'style'可以是'grouped' 或是'stacked'，沒設定的話預設值是'group'。

• 'grouped' 表示共有n群，每一群有m個垂直長條，其中n代表Y中列的數目，m 是代表Y中行的數目，在一群組中，Y中每一行用一長條表示。
• 'stacked' Y中每一列用一長條表示，長條的高度代表每一列所有元素的累計總和，每一個長條都可以包含多個顏色，不同顏色可用來代表每一列不同的元素，亦可表現出列中每個元素在總和中所佔的相對大小。

bar(...,LineSpec) 用LineSpec來指定長條的顏色。

h = bar(...) 傳回一貼片 ( patch ) 圖形物件 ( graphics object ) 的握把 ( handles ) 向量， barY中的每一行產生一個貼片圖形物件 ( patch graphics object )。

barh(...)， 和 h = barh(...) 產生水平長條，Y 決定長條的長度，向量x 是單調向量，用來定義水平長條在y軸上的間隔距離。

Examples

繪製一鐘形曲線圖:

x = -2.9:0.2:2.9;
bar(x,exp(-x.*x))
colormap hsv

產生四個subplots來表現各種bar參數的影響:

Y = round(rand(5,3)*10);
subplot(2,2,1)
bar(Y,'group')
title 'Group'

subplot(2,2,2) 
bar(Y,'stack')
title 'Stack'

subplot(2,2,3)
barh(Y,'stack')
title 'Stack'

subplot(2,2,4)
bar(Y,1.5)
title 'Width = 1.5'

See Also

bar3, ColorSpec, patch, stairs, hist

balance

bar3, bar3h