bar3h
3 次元横棒グラフ
説明
bar3h(___, は、x 軸および z 軸に沿ってバーの幅を設定し、グループ内におけるバーの間隔を制御します。既定では width)width は 0.8 で、バー同士がわずかに離れています。width が 1 の場合、グループ内のバーの間に隙間はありません。前述の構文にある任意の入力引数の組み合わせに加えて、width を指定します。
bar3h(___, は、バーのスタイルを指定します。ここで style)style には "detached"、"grouped" または "stacked" を指定できます。既定のスタイルは "detached" です。
h = bar3h(___)Surface オブジェクトを返します。y がベクトルの場合、bar3h は 1 つの Surface オブジェクトを作成します。y が行列の場合、bar3h は系列ごとに 1 つの Surface オブジェクトを返します。棒グラフを表示後、h を使用してバーのプロパティを設定します。プロパティの一覧については、Surface のプロパティ を参照してください。
例
y を 5 つの値のベクトルとして指定します。これらの値を 3 次元横棒グラフの系列としてプロットします。各バーの高さは y の値に対応し、z 軸上の位置はその値のインデックスに対応します。
y = [50 40 30 20 10]; bar3h(y);
y を行列として指定します。y の 3 次元横棒グラフを作成します。各系列は 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 を 4 つの系列をもつ行列として指定します。'grouped' スタイルを使用してグループ化された行ごとのデータで y をプロットします。同じグループのバーの間にあるスペースを削除するには、width を 1 に設定します。
y = [70 50 33 10; 75 55 35 15; 80 60 40 20];
bar3h(y,1,'grouped')
0 から π の範囲の z 座標のセットを作成します。z 値の正弦関数を 3 次元横棒グラフとしてプロットします。色指定 "r" を使用して、バーを赤色にします。
z = 0:pi/16:pi;
y = [sin(z')/4 sin(z')/2 sin(z')];
bar3h(z,y,1,"r")
データ行列 y をバー スタイル "stacked" とバー幅 0.5 を使用してプロットします。返された Surface オブジェクトを h に保存します。この場合、h には 4 つの要素があり、それぞれが 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 を呼び出して、axes オブジェクト ax1 および ax2 を作成します。axes オブジェクトを bar3h の最初の引数として指定することで、座標軸に個別の離散データ プロットを作成します。
積み上げ型の 3 次元横棒グラフを左の座標軸に表示します。右の座標軸には、同じデータのグループ化された横棒グラフを表示します。
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 の指定方法 | 例 | 結果 |
|---|---|---|---|
| 1 系列のバーを表示。 |
| ベクトル 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 の指定方法 | 例 | 結果 |
|---|---|---|---|
| 1 系列のバーを表示。 |
| ベクトル 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 値を中心とした隣接するバーとして表示します。 |
|
| 各グループを、色分けされた 1 つのバーとして表示します。バーの長さはグループ内の要素の合計です。 |
|
バーの色。次の表のオプションのいずれかとして指定します。
| 色名 | 省略名 | 外観 |
|---|---|---|
'red' | 'r' |
|
'green' | 'g' |
|
'blue' | 'b' |
|
'cyan' | 'c' |
|
'magenta' | 'm' |
|
'yellow' | 'y' |
|
'black' | 'k' |
|
'white' | 'w' |
|
axes オブジェクト。axes オブジェクトを指定しない場合、bar3h は現在の座標軸に棒グラフを作成します。
出力引数
詳細
バーの系列は、y の特定の列に対応するすべてのバーで構成されます。関数 bar3h は、各系列を x 軸に沿ってそれぞれ異なる位置で表示します。既定では、系列ごとに色が異なります。
次の図では、最初の系列が強調表示されています。
グループは、特定の y 位置にあるすべてのバーで構成されます。
次の図では、3 番目のグループが強調表示されています。
ヒント
プロットされたバーを変更するには、返された
Surfaceオブジェクトのプロパティを変更します。Surfaceプロパティの一覧については、Surface のプロパティを参照してください。
