Bar のプロパティ
棒グラフの外観と動作
Bar プロパティは、Bar オブジェクトの外観と動作を制御します。プロパティの値を変更することによって、棒グラフの特定の要素を変更できます。プロパティのクエリと設定にはドット表記を使用します。
b = bar(1:10); c = b.FaceColor b.FaceColor = [0 0.5 0.5];
色とスタイル
塗りつぶし色。'flat'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。'flat' オプションは、Bar オブジェクトの 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" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
R2017b から、この既定値は座標軸の ColorOrder プロパティの RGB 3 成分です。以前のリリースにおいて、この既定値は 'flat' で、色はカラーマップに基づいていました。
例: b = bar(1:10,'FaceColor','red')
例: b.FaceColor = [0 0.5 0.5];
例: b.FaceColor = 'flat';
例: b.FaceColor = '#D2F9A7';
FaceColor プロパティの設定方法を制御します。次のいずれかの値として指定します。
"auto"— MATLAB® がBarオブジェクトのSeriesIndexプロパティと座標軸のColorOrderプロパティを使用して、FaceColorプロパティ値を制御します。"manual"—Barオブジェクトを作成するときに、FaceColorプロパティ値を直接設定するか、関数の引数として間接的に設定します。
FaceColor プロパティの値を手動で変更すると、MATLAB は FaceColorMode プロパティの値を "manual" に変更します。
外枠の色。'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" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
例: b = bar(1:10,'EdgeColor','red')
例: b.EdgeColor = [0 0.5 0.5];
例: b.EdgeColor = 'flat';
例: b.EdgeColor = '#D2F9A7';
面の透明度。[0,1] の範囲のスカラーとして指定します。値 1 は不透明、値 0 は完全な透明を表します。0 と 1 の間の値は半透明です。
例: b = bar(1:10,'FaceAlpha',0.5)
例: b.FaceAlpha = 0.5;
エッジの透明度。[0,1] の範囲のスカラーとして指定します。値 1 は不透明、値 0 は完全な透明を表します。0 と 1 の間の値は半透明です。
例: b = bar(1:10,'EdgeAlpha',0.5)
例: b.EdgeAlpha = 0.5;
ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。
| ライン スタイル | 説明 | 結果として得られる線 |
|---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
シリーズ インデックス。正の整数または "none" として指定します。このプロパティは、テキスト、プロット ライン、またはその他の Bar オブジェクトなどのグラフィック オブジェクトの色を一致させるのに役立ちます。
既定では、Bar オブジェクトの SeriesIndex プロパティは、1 から始まる、作成順に対応する数値です。MATLAB は、この数値を使用して、プロット関数を呼び出すときに色を自動的に割り当てるインデックスを計算します。このインデックスは、座標軸の ColorOrder プロパティに格納されている配列の行を表します。同じ SeriesIndex 数値をもつ座標軸内のオブジェクトは同じ色をもちます。
SeriesIndex の値が "none" の場合は、インデックス方式に参加しない中間色に対応します。 (R2023b 以降)
手動の色割り当てにより SeriesIndex の動作をオーバーライドする方法
バーの色を手動で制御するには、以下のいずれかの方法を使用します。
すべてのバーに 1 つの色 -
FaceColorプロパティを、色名、RGB 3 成分、または 16 進数カラー コードに設定します。1 つ以上のバーに異なる色 —
FaceColorプロパティを"flat"に設定します。次にCDataプロパティを RGB 3 成分、RGB 3 成分の行列、スカラー カラーマップ インデックス、またはカラーマップ インデックスのベクトルに設定します。
Bar オブジェクトの色を手動で設定すると、MATLAB はそのオブジェクトの色の自動選択を無効にし、SeriesIndex プロパティの値に関係なく色を保持できるようにします。モード プロパティ FaceColorMode および CDataMode は、色が手動で (ユーザーにより) 設定されているか、自動的に設定されているかを示します。値 "manual" は手動選択を示し、値 "auto" は自動選択を示します。
自動選択を再度有効にするには、SeriesIndex プロパティを正の整数に設定し、以下のいずれかの手順を実行します。
FaceColorModeプロパティを"auto"に設定する。FaceColorプロパティを"flat"に設定し、CDataModeプロパティを"auto"に設定する。
場合によっては、MATLAB は SeriesIndex プロパティを 0 に設定し、色の自動選択も無効にします。
バーのラベル
R2024b 以降
バーのラベル。string ベクトル、文字ベクトルの cell 配列、数値ベクトル、datetime ベクトル、duration ベクトル、または categorical ベクトルとして指定します。ベクトルの長さはバーの数と一致しなければなりません。
チャートにグループ化されたバーまたは積み上げられたバーの複数の系列が表示される場合、各系列は 1 つの Bar オブジェクトに対応します。ラベルを付ける各 Bar オブジェクトに対して Labels プロパティを設定します。
R2024b 以降
バーのラベルの位置。"end-inside" または "end-outside" として指定します。ラベルに十分なスペースを確保するために、座標軸の範囲を調整する必要がある場合があります。
| 値 | 例 |
|---|---|
|
|
|
|
R2024b 以降
LabelLocation プロパティの設定方法を制御します。次のいずれかの値として指定します。
"auto"— バーがグループ化されているか積み上げられているかに応じて、MATLAB によってLabelLocationプロパティの値が制御されます。"manual"—LabelLocationプロパティの値を直接設定します。この位置は変更されません。
LabelLocation プロパティの値を手動で変更すると、MATLAB は LabelLocationMode プロパティの値を "manual" に変更します。
R2024b 以降
ラベルの色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。各ラベルに異なる色を使用するには、RGB 3 成分の m 行 3 列の行列、または m 個の 16 進数カラー コード、色名、または省略名を含む string ベクトルを指定します。値 m はラベル (バーごとに 1 つ) の数です。
カスタム色を使用する場合は、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" |
|
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
R2024b 以降
LabelColor プロパティの設定方法を制御します。次のいずれかの値として指定します。
"auto"— 対照的な中間色を選択することで、MATLAB によってLabelColorプロパティの値が制御されます。"manual"—LabelColorプロパティの値を直接設定します。この色は変更されません。
LabelColor プロパティの値を手動で変更すると、MATLAB は LabelColorMode プロパティの値を "manual" に変更します。
フォント サイズ。ポイント単位のゼロより大きいスカラー値として指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。1 ポイントは 1/72 インチです。
テキスト インタープリター。次の値のいずれかとして指定します。
'tex'— TeX マークアップのサブセットを使用して文字を解釈します。'latex'— LaTeX マークアップを使用して文字を解釈します。'none'— リテラル文字を表示します。
TeX マークアップ
MATLAB では、既定で TeX マークアップのサブセットをサポートしています。TeX マークアップを使用して、上付き文字や下付き文字の追加、フォントのタイプや色の変更、テキストへの特殊文字の挿入を行うことができます。
修飾子の効果はテキストの末尾まで適用されます。上付き文字と下付き文字は例外であり、次の 1 文字または中かっこで囲まれた文字にのみ適用されます。インタープリターを "tex" に設定した場合にサポートされる修飾子は次のとおりです。
| 修飾子 | 説明 | 例 |
|---|---|---|
^{ } | 上付き文字 | "text^{superscript}" |
_{ } | 下付き文字 | "text_{subscript}" |
\bf | 太字フォント | "\bf text" |
\it | イタリック フォント | "\it text" |
\sl | 斜体フォント (通常はイタリック フォントと同じ) | "\sl text" |
\rm | 標準フォント | "\rm text" |
\fontname{ | フォント名 — | "\fontname{Courier} text" |
\fontsize{ | フォント サイズ — | "\fontsize{15} text" |
\color{ | フォントの色 — red、green、yellow、magenta、blue、black、white、gray、darkGreen、orange、lightBlue の色のいずれかに置き換えます。 | "\color{magenta} text" |
\color[rgb]{specifier} | フォントのカスタムの色 — | "\color[rgb]{0,0.5,0.5} text" |
次の表に、"tex" インタープリターでサポートされる特殊文字を示します。
| 文字列 | 記号 | 文字列 | 記号 | 文字列 | 記号 |
|---|---|---|---|---|---|
| α |
| υ |
| ~ |
| ∠ |
| ϕ |
| ≤ |
|
|
| χ |
| ∞ |
| β |
| ψ |
| ♣ |
| γ |
| ω |
| ♦ |
| δ |
| Γ |
| ♥ |
| ϵ |
| Δ |
| ♠ |
| ζ |
| Θ |
| ↔ |
| η |
| Λ |
| ← |
| θ |
| Ξ |
| ⇐ |
| ϑ |
| Π |
| ↑ |
| ι |
| Σ |
| → |
| κ |
| ϒ |
| ⇒ |
| λ |
| Φ |
| ↓ |
| µ |
| Ψ |
| º |
| ν |
| Ω |
| ± |
| ξ |
| ∀ |
| ≥ |
| π |
| ∃ |
| ∝ |
| ρ |
| ∍ |
| ∂ |
| σ |
| ≅ |
| • |
| ς |
| ≈ |
| ÷ |
| τ |
| ℜ |
| ≠ |
| ≡ |
| ⊕ |
| ℵ |
| ℑ |
| ∪ |
| ℘ |
| ⊗ |
| ⊆ |
| ∅ |
| ∩ |
| ∈ |
| ⊇ |
| ⊃ |
| ⌈ |
| ⊂ |
| ∫ |
| · |
| ο |
| ⌋ |
| ¬ |
| ∇ |
| ⌊ |
| x |
| ... |
| ⊥ |
| √ |
| ´ |
| ∧ |
| ϖ |
| ∅ |
| ⌉ |
| 〉 |
| | |
| ∨ |
| 〈 |
| © |
LaTeX マークアップ
LaTeX マークアップを使用するには、インタープリターを "latex" に設定します。インライン モードでは、マークアップを 1 つのドル記号 ($) で囲みます。表示モードでは、マークアップを 2 つのドル記号 ($$) で囲みます。
| LaTeX モード | 例 | 結果 |
|---|---|---|
| インライン |
"$\int_1^{20} x^2 dx$" |
|
| 表示 |
"$$\int_1^{20} x^2 dx$$" |
|
テキストは LaTeX の既定のフォント スタイルで表示され、FontName、FontWeight、FontAngle のプロパティは無視されます。フォント スタイルを変更するには、LaTeX マークアップを使用します。
LaTeX インタープリターで使用できるテキストの最大サイズは 1200 文字です。複数行のテキストの場合は、さらに 1 行につき 10 文字ほど文字数が少なくなります。
MATLAB では、大半の標準の LaTeX 数式モード コマンドがサポートされています。詳細については、サポートされる LaTeX コマンドを参照してください。TeX および LaTeX の使用例については、チャートのテキスト内のギリシャ文字と特殊文字を参照してください。
棒グラフの種類
個々のバーの相対的な幅。範囲 [0, 1] のスカラーとして指定します。このプロパティは、グループ内におけるバーの間のスペースを制御するのに使用します。既定値は 0.8 であり、少し間隔を空けて各バーが表示されます。このプロパティを 1 に設定すると、バー同士が隙間なく表示されます。
たとえば、次の棒グラフは BarWidth の値以外は同じです。BarWidth の値が大きくなると、バーの幅が広くなります。
BarWidth の値は、バー グループのスペースの量を制御する GroupWidth プロパティに対する相対値です。GroupWidth の値が大きくなると、バーの幅が広くなります。 (R2024a 以降)
バーのグループをプロットすると複数の Bar オブジェクトが生成されます。いずれかのオブジェクトの BarWidth プロパティを変更すると、すべてのオブジェクトの値が変更されます。
R2024a 以降
バー グループの幅。範囲 [0, 1] のスカラーとして指定します。このプロパティは、バーのグループに対する使用可能なスペースの割合を指定します。バーがグループ化されていない場合は効果はありません。値が 1 の場合、使用可能なすべてのスペースが各グループに使用されますが、グループの間のスペースは最小になります。値が小さいほどバーが細くなり、グループの間のスペースが増えます。
たとえば、次の棒グラフは GroupWidth の値以外は同じです。GroupWidth の値が大きくなると、バーの幅が広くなり、グループが区別しにくくなります。
バーのグループをプロットすると複数の Bar オブジェクトが生成されます。いずれかのオブジェクトの GroupWidth プロパティを変更すると、すべてのオブジェクトの値が変更されます。
R2024a 以降
GroupWidth プロパティの設定方法を制御します。次の値のいずれかとして指定します。
"auto"— グループの数に基づいて MATLAB でGroupWidthの値が選択されます。"manual"— ユーザーがGroupWidthの値を指定します。
横棒グラフ。'on' または 'off' もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' の値は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。
ベースライン
データ
カラー データ。次のいずれかの値として指定します。
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];
CData プロパティの設定方法を制御します。次のいずれかの値として指定します。
"auto"— MATLAB によってCDataプロパティの値が制御されます。"manual"—Barオブジェクトを作成するときに、CDataプロパティ値を直接設定するか、関数の引数として間接的に設定します。
CData プロパティの値を手動で変更すると、MATLAB は CDataMode プロパティの値を "manual" に変更します。
バーの位置。重複する値のないベクトルとして指定します。
縦棒グラフの場合、値は x 軸上のバーの位置です。
横棒グラフの場合は y 軸上のバーの位置です。
あるいは、関数 bar または barh の入力引数 X を使用して、バーの位置を指定します。X を指定しない場合、YData の値のインデックスに基づいてバーの位置が決まります。
XData と YData は同じ長さでなければなりません。
例: 1:10
データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration
バーの長さ。ベクトルとして指定します。あるいは、関数 bar または barh の入力引数 Y を使用して、バーの長さを指定します。
XData と YData は同じ長さでなければなりません。
例: 1:10
データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | duration
この プロパティ は読み取り専用です。
バーの先端の x 座標。ベクトルとして返されます。これらの座標は、テキスト、誤差範囲、その他のオブジェクトをバーの先端に追加する場合に便利です。たとえば、バーの先端にテキストを追加する場合に、このプロパティの値を関数 text に渡すことができます。
この プロパティ は読み取り専用です。
バーの先端の y 座標。ベクトルとして返されます。これらの座標は、テキスト、誤差範囲、その他のオブジェクトをバーの先端に追加する場合に便利です。たとえば、バーの先端にテキストを追加する場合に、このプロパティの値を関数 text に渡すことができます。
