bar3
3 次元棒グラフ
説明
bar3(___, は、x 軸および y 軸に沿ってバーの幅を設定し、グループ内におけるバーの間隔を制御します。既定では width)width は 0.8 で、バー同士がわずかに離れています。width が 1 の場合、グループ内ではバー同士が隙間なく表示されます。
bar3(___, は、バーのスタイルを指定します。ここで style)style には 'detached'、'grouped' または 'stacked' を指定できます。既定の表示モードは 'detached' です。
b = bar3(___)Surface オブジェクトを返します。z がベクトルの場合、bar3 は 1 つの Surface オブジェクトを作成します。z が行列の場合、bar3 は系列ごとに 1 つの Surface オブジェクトを返します。棒グラフを表示後、b を使用してバーのプロパティを設定します。プロパティの一覧については、Surface のプロパティ を参照してください。
例
z を 5 つの値のベクトルとして指定します。これらの値を 3 次元棒グラフの系列としてプロットします。各バーの高さは z の値に対応し、y 軸上の位置はその値のインデックスに対応します。
z = [50 40 30 20 10]; bar3(z);
z を行列として指定します。z の 3 次元棒グラフを作成します。各系列は z の列に対応します。
z = [1 4 7; 2 5 8; 3 6 9; 4 7 10]; bar3(z)
y を z のバーに対する y 軸上の位置のベクトルとして指定します。指定した y 軸上の位置にバーをプロットします。
y = [1950 1960 1970 1980 1990]; z = [16 8 4 2 1]; bar3(y,z)
z を 3 つの系列をもつ行列として指定します。'grouped' スタイルを使用してグループ化された行ごとのデータで z をプロットします。同じグループのバーの間にあるスペースを削除するには、width を 1 に設定します。
z = [70 50 33 10; 75 55 35 15; 80 60 40 20];
bar3(z,1,'grouped')
0 から の範囲の y 座標のセットを作成します。y 値の正弦関数を 3 次元棒グラフとしてプロットします。色指定 'r' を使用して、バーを赤色にします。
y = 0:pi/16:pi;
z = [sin(y')/4 sin(y')/2 sin(y')];
bar3(y,z,1,'r')
データ行列 z をバー スタイル 'stacked' とバー幅 0.5 を使用してプロットします。返された Surface オブジェクトを b として保存します。この場合、b には 4 つの要素があり、それぞれが z の各列に対応します。
bar3 は既定のカラーマップに基づいて各系列の色を設定します。
z = [19 30 21 30; 40 16 32 12];
b = bar3(z,0.5,'stacked');
各系列の色をカスタマイズするには、b で対応するオブジェクトの FaceColor を設定します。
b(1).FaceColor = 'k'; b(2).FaceColor = 'white'; b(3).FaceColor = [.5 .7 .8]; b(4).FaceColor = [.9 .7 .8];
関数 tiledlayout および関数 nexttile を使用して、プロットをタイル表示できます。関数 tiledlayout を呼び出して、1 行 2 列のタイル表示チャート レイアウトを作成します。関数 nexttile を呼び出して、axes オブジェクト ax1 および ax2 を作成します。axes オブジェクトを bar3 に対する最初の引数として指定することで、座標軸に個別のライン プロットを作成します。
積み上げ型の 3 次元棒グラフを左の座標軸に表示します。右の座標軸には、同じデータのグループ化された棒グラフを表示します。
tiledlayout(1,2) z = [64 56 48; 49 42 35; 36 30 24]; % Left bar graph ax1 = nexttile; bar3(ax1,z,0.5,'stacked') % Right bar graph ax2 = nexttile; bar3(ax2,z,1,'grouped')
入力引数
z 座標。ベクトルまたは行列として指定します。z の各次元は、この関数がデータをどのように表示するかを決定します。次の表では、最も一般的な状況について説明します。
| 表示 | Y と Z の指定方法 | 例 | 結果 |
|---|---|---|---|
| 1 系列のバーを表示。 |
| ベクトル y = [1 2 3 4]; z = [10 20 30 40]; bar3(y,z) あるいは、 bar3(z) |
|
| x 軸に沿って積み上げられた複数の系列のバーを表示。 |
| ベクトル y = [1 2 3 4];
z = [1 5 9;
2 6 10;
3 7 11;
4 8 12];
bar3(y,z)あるいは、 bar3(z) |
|
データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | duration
y 座標。ベクトルとして指定します。y の値を順番にする必要はありませんが、y のサイズは、z のサイズとデータの表示方法によって異なります。次の表では、最も一般的な状況について説明します。
| 表示 | Y と Z の指定方法 | 例 | 結果 |
|---|---|---|---|
| 1 系列のバーを表示。 |
| ベクトル y = [1 2 3 4]; z = [10 20 30 40]; bar3(y,z) あるいは、 bar3(z) |
|
| x 軸に沿って積み上げられた複数の系列のバーを表示。 |
| ベクトル y = [1 2 3 4];
z = [1 5 9;
2 6 10;
3 7 11;
4 8 12];
bar3(y,z)あるいは、 bar3(z) |
|
データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration
バーの幅。各バーに使用可能な間隔全体に対する割合を表すスカラーとして指定します。既定値の 0.8 は、バー幅が前のバーと次のバーの間隔の 80% で、その間隔の 10% ずつがバーの両側にあることを示します。幅が 1 の場合、グループ内でバー同士が隙間なく表示されます。
例: bar3([1 2 3],0.5) は、使用可能な間隔の 50% を使用するバーを作成します。
データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
グループのスタイル。'detached'、'grouped' または 'stacked' として指定します。グループのスタイルは、複数のバーの系列を互いに対してどのように表示するかを決定します。z がベクトルの場合、スタイルはグラフの外観に影響しません。
次の表に、グループのスタイルの各オプションの結果を示します。
| グループのスタイル | 結果 | 例 |
|---|---|---|
| 各バーを、対応する x および y 値の位置に表示します。 |
|
| 各グループを、対応する y 値を中心とした隣接するバーとして表示します。 |
|
| 各グループを、色分けされた 1 つのバーとして表示します。バーの長さはグループ内の要素の合計です。 |
|
バーの色。次の表のオプションのいずれかとして指定します。
| 色名 | 省略名 | 外観 |
|---|---|---|
'red' | 'r' |
|
'green' | 'g' |
|
'blue' | 'b' |
|
'cyan' | 'c' |
|
'magenta' | 'm' |
|
'yellow' | 'y' |
|
'black' | 'k' |
|
'white' | 'w' |
|
axes オブジェクト。座標軸を指定しない場合、bar3 は棒グラフに現在の座標軸を使用します。
出力引数
詳細
バーの系列は、z の特定の列に対応するすべてのバーで構成されます。関数 bar3 は、各系列を x 軸に沿ってそれぞれ異なる位置で表示します。既定では、系列ごとに色が異なります。
次の図では、最初の系列が強調表示されています。
グループは、特定の y 位置にあるすべてのバーで構成されます。
次の図では、3 番目のグループが強調表示されています。
ヒント
プロットされたバーを変更するには、返された
Surfaceオブジェクトのプロパティを変更します。Surfaceプロパティの一覧については、Surface のプロパティを参照してください。
