pie3

3 次元円グラフ

• 

構文

pie3(X)

pie3(X,explode)

pie3(X,labels)

pie3(X,explode,labels)

pie3(ax,___)

p = pie3(___)

説明

pie3(X) は、X のデータを使用して 3 次元円グラフを描画します。円グラフの扇形はそれぞれ X の要素を表します。

pie3(X,explode) は、円グラフの中心からオフセットする扇形を指定します。

pie3(X,labels) は、扇形のテキスト ラベルを指定します。ラベル数は、X の要素数に等しくなる必要があります。

pie3(X,explode,labels) は、扇形をオフセットし、テキスト ラベルを指定します。

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

p = pie3(___) は、円グラフを構成する Patch、Surface、および Text オブジェクトのベクトルを返します。チャートのプロパティを作成後に変更するには、p を使用します。これらのオブジェクトに対して設定できるプロパティの一覧については、Patch のプロパティ、Surface のプロパティ、および Text のプロパティ を参照してください。

例

3 次元円グラフの作成

ベクトル X の 3 次元円グラフを作成します。

X = [1 3 0.5 2.5 2];
pie3(X)

円グラフの扇形のオフセット

3 次元円グラフを作成し、対応する explode 要素を 1 と指定して扇形をオフセットします。

X = [1 3 0.5 2.5 2];
explode = [0 1 0 0 0];
pie3(X,explode)

テキスト ラベルの指定

3 次元円グラフを作成し、テキスト ラベルを指定します。

X = 1:3;
labels = ["Taxes" "Expenses" "Profit"];
pie3(X,labels)

フォント スタイルの変更

3 次元円グラフを作成し、1 つのラベルのフォント スタイルを変更します。

最初に、既定のフォント スタイルで 3 次元円グラフを作成します。円グラフのカスタマイズに使用できるように、出力引数 p を指定します。

X = [1 2 3];
labels = ["Taxes" "Expenses" "Profit"];
p = pie3(X,labels);

p には、円グラフの各扇形の対応する 4 つの要素 Patch、Surface、Patch、および Text が含まれます。

p'

ans = 
  12×1 graphics array:

  Patch
  Surface    (Taxes)
  Patch
  Text       (Taxes)
  Patch
  Surface    (Expenses)
  Patch
  Text       (Expenses)
  Patch
  Surface    (Profit)
  Patch
  Text       (Profit)

ラベル Expenses の Text オブジェクトを取得します。ドット表記を使用して関連するプロパティを設定することにより、色とフォント サイズを変更します。

t = p(8);
t.Color = "red";
t.FontSize = 14;

2 つの円グラフの比較

タイル表示チャート レイアウトを使用して、2 つの 3 次元円グラフを同じ Figure にプロットして比較します。

2010 年および 2011 年の財務データのベクトルと一連のラベルのベクトルを作成します。

y2010 = [50 0 100 95];
y2011 = [65 22 97 120];
labels = ["Investments" "Cash" "Operations" "Sales"];

2 行 1 列のタイル表示チャート レイアウトを作成します。最初のタイルで 2010 年、2 番目のタイルで 2011 年の円グラフを作成します。円グラフの共有の凡例を追加します。

t = tiledlayout(1,2,"TileSpacing","None");
ax1 = nexttile;
pie3(ax1,y2010)
title("2010")

ax2 = nexttile;
pie3(ax2,y2011)
title("2011")

l = legend(labels);
l.Layout.Tile = "south";

入力引数

X — 入力配列

ベクトル | 行列

入力配列。数値のベクトルまたは行列として指定します。X の各要素は円グラフの扇形に対応します。X のすべての要素の合計 S により、pie3 でチャートがどのように表示されるかが決まります。

• S = 1 の場合、X の値は扇形の比率を指定します。

• S < 1 の場合、X の値は扇形の比率を指定し、pie3 は部分的な円グラフを描画します。

• S > 1 の場合、pie3 はそれぞれの扇形のサイズを S で正規化します。

explode — オフセットする扇形

数値ベクトルまたは行列 | logical ベクトルまたは logical 行列

オフセットする扇形。X と同じサイズの数値または logical ベクトルまたは行列として指定します。扇形をオフセットするには、対応する要素を非ゼロ値または true のいずれかに設定します。非ゼロ要素の値はオフセットに影響しません。

例: [0 1 0 0] は、2 番目の扇形をオフセットします。

labels — テキスト ラベル

string 配列 | 文字ベクトルの cell 配列

扇形のテキスト ラベル。string 配列または文字ベクトルの cell 配列として指定します。ラベルを指定しない場合、pie3 は自動的にパーセンテージ値を表示します。

ax — ターゲット座標軸

Axes オブジェクト

ターゲット座標軸。Axes オブジェクトとして指定します。座標軸を指定しない場合、MATLAB^® は現在の座標軸にプロットするか、存在しない場合は Axes オブジェクトを作成します。

出力引数

p — グラフィックス オブジェクト

Patch、Surface、および Text オブジェクトのベクトル

円グラフを構成するグラフィックス オブジェクト。Patch、Surface、および Text オブジェクトのベクトルとして返されます。

円グラフの各扇形は、チャートの外観を変更するために使用できる 4 つのオブジェクトで構成されます。結果として、出力ベクトルの長さは X の要素数の 4 倍になります。p には、各扇形の対応する 4 つの要素が次の順序で含まれます。

• Patch オブジェクト – 下位レイヤー (イメージでは見えない)

• Surface オブジェクト – 上位レイヤーと下位レイヤーの間の表面 (イメージのオレンジの部分)

• Patch オブジェクト – 上位レイヤー (イメージの青の部分)

• Text オブジェクト – テキスト ラベル

これらのオブジェクトに対して設定できるプロパティの詳細については、Patch のプロパティ、Surface のプロパティ、および Text のプロパティ を参照してください。

拡張機能

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

pie3 関数は GPU 配列入力をサポートしますが、次の使用上の注意および制限があります。

• この関数は GPU 配列を受け入れますが、GPU 上では実行されません。

詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

使用上の注意および制限:

• この関数は分散配列に対して演算を行いますが、クライアントの MATLAB で実行されます。

詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2006a より前に導入

R2019b: 円グラフへのゼロ値の表示

関数 pie3 を呼び出してゼロ値を含むデータを指定すると、円グラフにゼロ値とそれに対応するラベルが表示されます。出力引数を指定して pie3 を呼び出すと、出力には各ゼロ値のオブジェクトが含まれます。

以前のリリースでは、pie3 はグラフからゼロ値を除外し、それらの値に対応するオブジェクトを返しませんでした。ゼロ値を表示しないようにしたり、対応するオブジェクトを返さないようにするには、プロットする前にデータからゼロを削除してください。

参考

pie