ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

bar

説明

bar(y) は、y の各要素を 1 本のバーで表す棒グラフを作成します。y が行列の場合、bary の行別にバーをグループ化します。

bar(x,y) は、x で指定された位置にバーを描画します。

bar(___,width) は、バーの相対的な幅を設定し、グループ内におけるバーの間隔を制御します。width はスカラー値として指定します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。

bar(___,style) は、バー グループのスタイルを指定します。たとえば、各グループを色分けされた 1 つのバーとして表示するには 'stacked' を使用します。

bar(___,color) は、すべてのバーの色を設定します。たとえば、バーの色を赤にするには 'r' を使用します。

bar(___,Name,Value) は、1 つ以上の名前と値のペアの引数を使用して棒グラフを変更します。この設定は、プロットされるすべてのバーに適用されます。たとえば、すべてのバーの輪郭の色を黒にするには 'EdgeColor','black' を使用します。

bar(ax,___) は、現在の座標軸 (gca) の代わりに ax によって指定される座標軸にプロットします。オプションの ax は、前述の構文のすべての入力引数の組み合わせより前に指定できます。

b = bar(___) は、1 つ以上の Bar オブジェクトを返します。y がベクトルの場合、bar は 1 つの Bar オブジェクトを作成します。y が行列の場合、bar は列ごとに 1 つの Bar オブジェクトを作成します。作成後の Bar オブジェクトを変更するには、b を使用します。

すべて折りたたむ

y = [75 91 105 123.5 131 150 179 203 226 249 281.5];
bar(y)

バーの x 軸上の位置を指定します。

x = 1900:10:2000;
y = [75 91 105 123.5 131 150 179 203 226 249 281.5];
bar(x,y)

各バーの幅を、各バーに使用可能な間隔全体の 40% に設定します。

y = [75 91 105 123.5 131 150 179 203 226 249 281.5];
bar(y,0.4)

3 つのバーからなる 4 つのグループを表示します。

y = [2 2 3; 2 5 6; 2 8 9; 2 11 12];
bar(y)

行列の行ごとに 1 本のバーを表示します。各バーの高さは行の要素の合計になります。

y = [2 2 3; 2 5 6; 2 8 9; 2 11 12];
bar(y,'stacked')

x 軸にカテゴリカル値をもつ棒グラフを作成します。カテゴリは既定でアルファベット順に表示されます。

c = categorical({'apples','pears','oranges'});
prices = [1.23 0.99 2.3];
bar(c,prices)

2 つのサブプロットを含む Figure を作成します。上のサブプロットでは、棒グラフをプロットします。下のサブプロットでは、同じデータの積み上げ型の棒グラフをプロットします。

y = [1 2 3; 4 5 6];
ax1 = subplot(2,1,1);
bar(ax1,y)

ax2 = subplot(2,1,2); 
bar(ax2,y,'stacked')

バーの色を赤にして棒グラフを作成します。

y = [75 91 105 123.5 131 150 179 203 226 249 281.5];
bar(y,'r')

バーの内部の色と外枠の色を RGB 3 成分を使用して指定します。バーの外枠の幅を設定します。

y = [75 91 105 123.5 131 150 179 203 226 249 281.5];
bar(y,'FaceColor',[0 .5 .5],'EdgeColor',[0 .9 .9],'LineWidth',1.5)

Bar オブジェクトの CData プロパティを使用して個々のバーの色を制御します。

棒グラフを作成し、Bar オブジェクトを変数に割り当てます。Bar オブジェクトの FaceColor プロパティを 'flat' に設定して、CData プロパティで定義された色をグラフで使用します。既定では、CData プロパティに既定の RGB カラー値の行列が事前入力されています。特定の色を変更するには、行列の対応する行を変更します。たとえば、2 番目のバーの色を変更します。

b = bar(rand(10,1));
b.FaceColor = 'flat';
b.CData(2,:) = [.5 0 .5];

FaceColor プロパティを 'flat' に設定して、カラーマップの色を使用する棒グラフを作成します。次に、各 Bar オブジェクトの CData プロパティを整数に設定します。

y = [1 3 5; 3 2 7; 3 4 2];
b = bar(y,'FaceColor','flat');
for k = 1:size(y,2)
    b(k).CData = k;
end

3 列の行列入力を指定して棒グラフを作成します。3 つの bar series オブジェクトが返されます。bar は、行列の列ごとに 1 つの bar series を作成します。

y = [2 4 6; 3 4 5];
b = bar(y);

このオブジェクト配列のインデックスを指定して、特定の bar series のプロパティを変更します。たとえば、y の 2 番目の列を表すバーのプロパティを変更するには b(2) を使用します。R2014b から、プロパティの設定にドット表記を使用できるようになりました。それより前のリリースを使用している場合は、代わりに関数setを使用してください。

b(2).LineWidth = 2;
b(2).EdgeColor = 'red';

入力引数

すべて折りたたむ

x 値。ベクトルまたは行列として指定します。xy がどちらもベクトルの場合、両方を同じ長さにしなければなりません。xy がどちらも行列の場合、両方を同じサイズにしなければなりません。x がベクトルで y が行列の場合は、x の長さが y の行数と等しくなければなりません。

x 値は任意の順序でかまいませんが、重複する値を含んではなりません。x が行列の場合、列方向に重複する値があってはなりません。

例: 1:10

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

y 値。ベクトルまたは行列として指定します。

  • y がベクトルの場合、bar は要素ごとに 1 本のバーを描画します。関数 bar は、すべてのベクトルを列ベクトルとして扱います。

  • y が行列の場合、bary の行別にバーをグループ化します。

例: [10 8 5 7 3 9 1]

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | duration

バーの幅。各バーに使用可能な間隔全体に対する割合として指定します。既定値の 0.8 は、バー幅が前のバーと次のバーの間隔の 80% で、その間隔の 10% ずつがバーの両側にあることを示します。

幅が 1 の場合、グループ内でバー同士が隙間なく表示されます。

例: 0.5

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

バー グループのスタイル。次の値のいずれかとして指定します。

スタイル目的

'grouped'

y の行ごとに 1 つのグループを表示します。

  • ymn 列の行列である場合、bar は、n 個の縦棒で構成される m 個のグループを表示します。m は行数で、ny の列数です。

  • y が長さ n のベクトルの場合、barn 個のバーからなる 1 つのグループを表示します。関数 bar は、すべてのベクトルを列ベクトルとして扱います。

'stacked'

y の行ごとに 1 本のバーを表示します。

  • ymn 列の行列の場合、bar によって表示される m 個のバーのそれぞれの高さは、行に含まれる要素の合計になります。各バーは、複数のカラーで色分けされています。各カラーはそれぞれの要素に対応し、行の各要素が合計に占める相対的な割合を示します。

  • y が長さ n のベクトルの場合、barn 個のバーを表示します。関数 bar は、すべてのベクトルを列ベクトルとして扱います。

'histc'

グラフをヒストグラム形式で表示します。グラフ内ではバー同士が隙間なく表示されます。このオプションは Bar オブジェクトの代わりに Patch オブジェクトを作成します。このオプションを使用する場合、名前と値のペアの引数は指定できません。

'hist'

グラフをヒストグラム形式で表示しますが、histc オプションのようにバーを x 軸上の複数の目盛りにまたがって表示するのではなく、x 軸上の目盛りの中心に各バーを配置します。このオプションは Bar オブジェクトの代わりに Patch オブジェクトを作成します。このオプションを使用する場合、名前と値のペアの引数は指定できません。

バーの色。次の表の色のいずれかとして指定します。

'b'
'r'
'g'
'c'シアン
'm'マゼンタ
'y'
'k'
'w'

axes オブジェクト。座標軸を指定しない場合、bar は棒グラフに現在の座標軸を使用します。

名前と値のペアの引数

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順序で指定できます。

例: 'EdgeColor','g' は、バーの外枠の色を緑に指定します。

ここでは、Bar プロパティの一部だけを紹介しています。完全な一覧については、Bar のプロパティ を参照してください。

メモ

バー グループのスタイル オプションとして 'hist' または 'histc' を使用する場合は Name,Value のペアを指定することはできません。

外枠の色。'flat'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。150 本以下のバーがある場合、既定値は [0 0 0] で黒に相当します。150 本を超えるバーがある場合、既定値は 'none' です。

R2017b から、'flat' オプションは CData 値を使用してエッジに着色します。以前のリリースにおいて、'flat' オプションはカラーマップの色を使用してエッジに色を付けていました。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

  • RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

  • 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラー コード '#FF8800''#ff8800''#F80'、および '#f80' は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

色名省略名RGB 3 成分16 進数カラー コード外観
'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'該当なし該当なし該当なし色なし

MATLAB® の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

例: b = bar(1:10,'EdgeColor','red')

例: b.EdgeColor = [0 0.5 0.5];

例: b.EdgeColor = 'flat';

例: b.EdgeColor = '#D2F9A7';

塗りつぶし色。'flat'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。'flat' オプションは CData 値を使用して面に着色します。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

  • RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

  • 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラー コード '#FF8800''#ff8800''#F80'、および '#f80' は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

色名省略名RGB 3 成分16 進数カラー コード外観
'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'該当なし該当なし該当なし色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

R2017b から、この既定値は座標軸の ColorOrder プロパティの RGB 3 成分です。以前のリリースにおいて、この既定値は 'flat' で、色はカラーマップに基づいていました。

例: b = bar(1:10,'FaceColor','red')

例: b.FaceColor = [0 0.5 0.5];

例: b.FaceColor = 'flat';

例: b.FaceColor = '#D2F9A7';

カラー データ。次のいずれかの値として指定します。

  • RGB 3 成分 — 単一の RGB カラー値をすべてのバーに適用します。

  • 3 列の行列 — バーごとに 1 色。行列の各行は、特定のバーの RGB 3 成分を指定します。

  • スカラー — 単一の色をすべてのバーに適用します。この色はカラーマップから得られます。

  • ベクトル — バーごとに 1 色。色はカラーマップから得られます。

既定では、棒グラフを作成するときに CData プロパティに RGB 3 成分から成る 3 列の行列が含まれます。行列内の対応する行を変更することで、特定のバーの色を変更できます。

このプロパティは、FaceColor または EdgeColor プロパティが 'flat' に設定されている場合にのみ適用されます。

FaceColor プロパティを 'flat' に設定して、特定のバーの色を変更します。次に、行列 CData 内の対応する行を新しい RGB 3 成分に変更します。たとえば、2 番目のバーの色を変更します。

b = bar(1:10,'FaceColor','flat');
b.CData(2,:) = [0 0.8 0.8];

ベースライン値。スカラー数値として指定します。

指定したベースライン値は、棒グラフの方向に応じて x 軸または y 軸のいずれかに適用されます。棒グラフの方向を垂直から水平に、またはその逆に変更した場合、ベースライン値は変更されることがあります。BaseValue プロパティは、Horizontal プロパティを設定した後に設定してください。

バーの外枠のライン スタイル。次の表のライン スタイルのいずれかとして指定します。

ライン スタイルライン スタイル結果として得られる線
'-'実線

'--'破線

':'点線

'-.'一点鎖線

'none'ラインなしラインなし

バーの外枠の幅。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。

例: 1.5

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

出力引数

すべて折りたたむ

Bar オブジェクト。作成後に特定の Bar オブジェクトのプロパティにアクセスして変更するには、b の要素を使用します。

拡張機能

R2006a より前に導入