bubblechart3

3 次元バブル チャート

R2020b 以降

• 

×

構文

bubblechart3(x,y,z,sz)

bubblechart3(x,y,z,sz,c)

bubblechart3(tbl,xvar,yvar,zvar,sizevar)

bubblechart3(tbl,xvar,yvar,zvar,sizevar,cvar)

bubblechart3(ax,___)

bubblechart3(___,Name,Value)

bc = bubblechart3(___)

説明

ベクトルと行列のデータ

bubblechart3(x,y,z,sz) は、x、y、z で指定された場所に色付きの円マーカー (バブル) を表示し、バブルのサイズを sz で指定します。

• 1 つの座標セットをプロットするには、x、y、z、および sz を等しい長さのベクトルとして指定します。

• 同じ座標軸セットに複数の座標セットをプロットするには、x、y、z、sz のうちの少なくとも 1 つを行列として指定します。

bubblechart3(x,y,z,sz,c) は、バブルの色を指定します。すべてのバブルに 1 つの色を指定することも、色を変えることもできます。たとえば、c を "red" として指定すると、すべてのバブルを赤でプロットできます。

テーブル データ

bubblechart3(tbl,xvar,yvar,zvar,sizevar) は、table tbl の変数 xvar、yvar、および zvar をプロットし、変数 sizevar をバブル サイズに使用します。1 つのデータ セットをプロットするには、xvar、yvar、zvar、および sizevar にそれぞれ 1 つの変数を指定します。複数のデータ セットをプロットするには、それらの引数の少なくとも 1 つに複数の変数を指定します。複数の変数を指定する引数では、同数の変数を指定しなければなりません。

bubblechart3(tbl,xvar,yvar,zvar,sizevar,cvar) は、変数 cvar で指定された色を使用して、table の指定された変数をプロットします。複数のデータ セットの色を指定するには、cvar に複数の変数を指定します。変数の数はデータ セットの数と一致しなければなりません。

追加オプション

bubblechart3(ax,___) は、ターゲット座標軸 ax にバブル チャートを表示します。他のすべての入力引数の前に座標軸を指定します。

bubblechart3(___,Name,Value) は、1 つ以上の名前と値の引数を使用して、BubbleChart プロパティを指定します。プロパティは他のすべての入力引数の後に指定します。たとえば、bubblechart3(x,y,z,'LineWidth',2) は、マーカーの輪郭が 2 ポイントのバブル チャートを作成します。プロパティの一覧については、BubbleChart のプロパティ を参照してください。

bc = bubblechart3(___) は、BubbleChart オブジェクトを返します。チャートのプロパティを作成後に変更するには、bc を使用します。プロパティの一覧については、BubbleChart のプロパティ を参照してください。

例

ランダムなバブルのプロット

バブル座標のセットをベクトル x、y、および z として定義します。sz を、バブルのサイズを指定するベクトルとして定義します。次に、x、y、および z のバブル チャートを作成します。

x = rand(1,20);
y = rand(1,20);
z = rand(1,20);
sz = rand(1,20);
bubblechart3(x,y,z,sz);

バブルの色の指定

バブル座標のセットをベクトル x、y、および z として定義します。sz を、バブルのサイズを指定するベクトルとして定義します。次に、x、y、および z のバブル チャートを作成し、色を赤として指定します。既定では、バブルは一部透明です。

x = rand(1,20);
y = rand(1,20);
z = rand(1,20);
sz = rand(1,20);
bubblechart3(x,y,z,sz,'red');

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定できます。たとえば、16 進数カラー コード '#7031BB' は、紫の色調を指定します。

bubblechart3(x,y,z,sz,'#7031BB');

各バブルに異なる色を指定することもできます。たとえば、Figure のカラーマップから色を選択するベクトルを指定します。

c = 1:20;
bubblechart3(x,y,z,sz,c)

バブルの透明度と外枠の色の指定

バブル座標のセットをベクトル x、y、および z として定義します。sz を、バブルのサイズを指定するベクトルとして定義します。次に、x、y、および z のバブル チャートを作成します。既定では、バブルは 60% 不透明で、エッジは同じ色で完全に不透明です。

x = rand(1,20);
y = rand(1,20);
z = rand(1,20);
sz = rand(1,20);
bubblechart3(x,y,z,sz);

不透明度と外枠の色は、それぞれ MarkerFaceAlpha プロパティと MarkerEdgeColor プロパティを設定してカスタマイズできます。プロパティを設定する 1 つの方法として、チャートを作成するときに名前と値のペアの引数を指定します。たとえば、MarkerFaceAlpha 値を 0.20 に設定して 20% の不透明度を指定できます。

bc = bubblechart3(x,y,z,sz,'MarkerFaceAlpha',0.20);

戻り引数を指定した関数 bubblechart3 を呼び出してチャートを作成すると、チャートを作成した後に、戻り引数を使用してチャートにプロパティを設定することができます。たとえば、外枠の色を紫に変更できます。

bc.MarkerEdgeColor = [0.5 0 0.5];

バブル凡例の追加

都市圏のさまざまな都市における特定の毒素の汚染レベルを示すデータ セットを定義します。

• towns を都市の人口として定義します。

• nsites を対応する都市内の産業用地の数として定義します。

• nregulated を地域の環境規制に準拠した産業用地の数として定義します。

• levels を都市の汚染レベルとして定義します。

towns = randi([25000 500000],[1 30]);
nsites = randi(10,1,30);
nregulated = (-3 * nsites) + (5 * randn(1,30) + 20);
levels = (3 * nsites) + (7 * randn(1,30) + 20);

データをバブル チャートに表示します。関数 xlabel、ylabel、および zlabel を使用して軸ラベルを作成します。関数 bubblesize を使用して、すべてのバブルの直径を 5 ～ 30 ポイントにします。次に、バブル サイズと人口の関係を示すバブル凡例を追加します。

bubblechart3(nsites,nregulated,levels,towns)
xlabel('Industrial Sites')
ylabel('Regulated Sites')
zlabel('Contamination Level')

bubblesize([5 30])
bubblelegend('Town Population','Location','eastoutside')

table のデータのプロット

table のデータをプロットするには、table を関数 bubblechart3 に渡してプロット対象の変数を指定すると便利です。たとえば、5 つの乱数の変数をもつ table を作成します。table を最初の引数として関数 bubblechart3 に渡し、続けて変数名を渡すことにより、変数 X1、Y、Z、および Sz をプロットします。既定では、軸ラベルは変数名と一致します。

tbl = table(randn(15,1)-10,randn(15,1)+10,rand(15,1), ...
  rand(15,1),rand(15,1), ...
  'VariableNames',{'X1','X2','Y','Z','Sz'});

bubblechart3(tbl,'X1','Y','Z','Sz')

また、複数の変数を同時にプロットできます。たとえば、xvar 引数を cell 配列 {'X1','X2'} として指定することにより、変数 X1 および X2 を "x" 軸にプロットします。次に、凡例を追加します。凡例ラベルは変数名と一致します。

bubblechart3(tbl,{'X1','X2'},'Y','Z','Sz')
legend

カスタムの色を使用した table データのプロット

bubblechart3 を呼び出すときに cvar 引数を指定することで、table のデータをプロットして色をカスタマイズできます。

たとえば、5 つの乱数の変数をもつ table を作成し、変数 X、Y、および Z をプロットします。変数 Sz に応じてバブル サイズを変化させ、変数 Colors に応じて色を変化させます。

tbl = table(randn(15,1)-10,randn(15,1)+10,rand(15,1), ...
  rand(15,1),rand(15,1), ...
  'VariableNames',{'X','Y','Z','Sz','Colors'});

bubblechart3(tbl,'X','Y','Z','Sz','Colors');

同じスケール上の異なる座標軸へのバブルの表示

特定の都市圏の東側と西側にある複数の都市における特定の毒素の汚染レベルを示す 2 組のデータ セットを定義します。

• towns1 and towns2 を都市の人口として定義します。

• nsites1 と nsites2 を対応する都市の産業用地の数として定義します。

• nregulated1 および nregulated2 を地域の環境規制に準拠した産業用地の数として定義します。

• levels1 と levels2 を都市の汚染レベルとして定義します。

towns1 = randi([25000 500000],[1 30]);
towns2 = towns1/3;
nsites1 = randi(10,1,30);
nsites2 = randi(10,1,30);
nregulated1 = (-3 * nsites1) + (5 * randn(1,30) + 20);
nregulated2 = (-2 * nsites2) + (5 * randn(1,30) + 20);
levels1 = (3 * nsites1) + (7 * randn(1,30) + 20);
levels2 = (5 * nsites2) + (7 * randn(1,30) + 20);

タイル表示チャート レイアウトを作成して、データを左右に並べて可視化できます。次に、1 つ目のタイルに axes オブジェクトを作成し、都市の東側のデータをプロットします。タイトルと座標軸ラベルを追加します。2 番目のタイルでこの処理を繰り返して、西側のデータをプロットします。

tiledlayout(2,1,'TileSpacing','compact')
ax1 = nexttile;

% East side
bubblechart3(ax1,nsites1,nregulated1,levels1,towns1);
title('East Side')
xlabel('Industrial Sites')
ylabel('Regulated Sites')
zlabel('Contamination Level')

% West side
ax2 = nexttile;
bubblechart3(ax2,nsites2,nregulated2,levels2,towns2);
title('West Side')
xlabel('Industrial Sites')
ylabel('Regulated Sites')
zlabel('Contamination Level')

すべてのバブル サイズを小さくして、すべてのバブルが表示されるようにします。この場合、直径の範囲を 5 ～ 20 ポイントに変更します。

bubblesize(ax1,[5 20])
bubblesize(ax2,[5 20])

東側の都市は西側の都市の 3 倍の大きさですが、前のチャートのバブル サイズにはこの情報は反映されていません。これは、最小バブルと最大バブルが、各座標軸の最小データ点と最大データ点にマッピングされるためです。同じスケールにバブルを表示するには、都市の両側からの人口を含む alltowns という名前のベクトルを定義します。関数 bubblelim を使用して、両方のチャートのスケーリングをリセットします。

alltowns = [towns1 towns2];
newlims = [min(alltowns) max(alltowns)];
bubblelim(ax1,newlims)
bubblelim(ax2,newlims)

入力引数

x — x 座標

スカラー | ベクトル | 行列

x 座標。スカラー、ベクトルまたは行列として指定します。x のサイズと形状はデータの形状に依存します。次の表では、最も一般的な状況について説明します。

バブル チャートのタイプ	座標の指定方法
1 つのバブル	x、y、z、および sz をスカラーとして指定します。以下に例を示します。 bubblechart3(1,2,3,10)
1 つのバブル セット	x、y、z、および sz を、同じ長さの行ベクトルまたは列ベクトルの任意の組み合わせとして指定します。以下に例を示します。 x = [1 2 3 4]; y = [4; 5; 6; 7]; z = [8 9 10 11]; sz = [12 13 14 15]; bubblechart3(x,y,z,sz)
複数のバブル セット	すべてのデータ セットが 1 つ以上の次元で座標を共有している場合は、共有している座標をベクトルとして指定し、他の座標を行列として指定します。ベクトルの長さは行列の次元の 1 つと一致していなければなりません。たとえば、同じ x 座標とサイズの値を共有する 2 つのデータ セットをプロットします。 x = [1 2 3 4]; y = [4 5 6 7; 7 8 9 10]; z = [10 11 12 13; 14 15 16 17]; sz = [1 2 3 4]; bubblechart3(x,y,z,sz) 行列が正方の場合、bubblechart3 は行列の列ごとに別個のバブルのセットをプロットします。 または、x、y、z、および sz をサイズが等しい行列として指定します。この場合、bubblechart3 は行列の各列をプロットします。たとえば、2 つのデータ セットをプロットします。 x = [1 1; 2 2; 3 3; 4 4]; y = [4 7; 5 8; 6 9; 7 10]; z = [10 14; 11 15; 12 16; 13 17]; sz = [1 1; 2 2; 3 3; 4 4]; bubblechart3(x,y,z,sz)

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

y — y 座標

スカラー | ベクトル | 行列

y 座標。スカラー、ベクトルまたは行列として指定します。y のサイズと形状はデータの形状に依存します。次の表では、最も一般的な状況について説明します。

バブル チャートのタイプ	座標の指定方法
1 つのバブル	x、y、z、および sz をスカラーとして指定します。以下に例を示します。 bubblechart3(1,2,3,10)
1 つのバブル セット	x、y、z、および sz を、同じ長さの行ベクトルまたは列ベクトルの任意の組み合わせとして指定します。以下に例を示します。 x = [1 2 3 4]; y = [4; 5; 6; 7]; z = [8 9 10 11]; sz = [12 13 14 15]; bubblechart3(x,y,z,sz)
複数のバブル セット	すべてのデータ セットが 1 つ以上の次元で座標を共有している場合は、共有している座標をベクトルとして指定し、他の座標を行列として指定します。ベクトルの長さは行列の次元の 1 つと一致していなければなりません。たとえば、同じ x 座標とサイズの値を共有する 2 つのデータ セットをプロットします。 x = [1 2 3 4]; y = [4 5 6 7; 7 8 9 10]; z = [10 11 12 13; 14 15 16 17]; sz = [1 2 3 4]; bubblechart3(x,y,z,sz) 行列が正方の場合、bubblechart3 は行列の列ごとに別個のバブルのセットをプロットします。 または、x、y、z、および sz をサイズが等しい行列として指定します。この場合、bubblechart3 は行列の各列をプロットします。たとえば、2 つのデータ セットをプロットします。 x = [1 1; 2 2; 3 3; 4 4]; y = [4 7; 5 8; 6 9; 7 10]; z = [10 14; 11 15; 12 16; 13 17]; sz = [1 1; 2 2; 3 3; 4 4]; bubblechart3(x,y,z,sz)

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

z — z 座標

スカラー | ベクトル | 行列

z 座標。スカラー、ベクトルまたは行列として指定します。z のサイズと形状はデータの形状に依存します。次の表では、最も一般的な状況について説明します。

バブル チャートのタイプ	座標の指定方法
1 つのバブル	x、y、z、および sz をスカラーとして指定します。以下に例を示します。 bubblechart3(1,2,3,10)
1 つのバブル セット	x、y、z、および sz を、同じ長さの行ベクトルまたは列ベクトルの任意の組み合わせとして指定します。以下に例を示します。 x = [1 2 3 4]; y = [4; 5; 6; 7]; z = [8 9 10 11]; sz = [12 13 14 15]; bubblechart3(x,y,z,sz)
複数のバブル セット	すべてのデータ セットが 1 つ以上の次元で座標を共有している場合は、共有している座標をベクトルとして指定し、他の座標を行列として指定します。ベクトルの長さは行列の次元の 1 つと一致していなければなりません。たとえば、同じ x 座標とサイズの値を共有する 2 つのデータ セットをプロットします。 x = [1 2 3 4]; y = [4 5 6 7; 7 8 9 10]; z = [10 11 12 13; 14 15 16 17]; sz = [1 2 3 4]; bubblechart3(x,y,z,sz) 行列が正方の場合、bubblechart3 は行列の列ごとに別個のバブルのセットをプロットします。 または、x、y、z、および sz をサイズが等しい行列として指定します。この場合、bubblechart3 は行列の各列をプロットします。たとえば、2 つのデータ セットをプロットします。 x = [1 1; 2 2; 3 3; 4 4]; y = [4 7; 5 8; 6 9; 7 10]; z = [10 14; 11 15; 12 16; 13 17]; sz = [1 1; 2 2; 3 3; 4 4]; bubblechart3(x,y,z,sz)

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

sz — バブルのサイズ

数値スカラー | ベクトル | 行列

バブルの相対サイズ。数値スカラー、ベクトル、または行列として指定します。

sz 値は、バブルのサイズの相対分布を制御します。既定では、bubblechart3 は座標軸のすべてのバブル チャートに対して、sz 値の範囲全体でバブル領域の範囲を線形にマッピングします。バブルの絶対サイズをより詳細に制御する方法と、sz 値の範囲にマッピングする方法については、bubblesize および bubblelim を参照してください。

sz をスカラー、ベクトル、行列のどれに指定するかは、x、y、z の指定方法や目的のチャートの外観によって異なります。次の表では、最も一般的な状況について説明します。

バブル チャートのタイプ	x、y、z	sz	例
1 つのバブル セット	同じ長さのベクトル	x、y、および z と同じ長さのベクトル	x、y、z、および sz をベクトルとして指定します。 x = [1 2 3 4]; y = [4 5 6 7]; z = [8 9 10 11]; sz = [80 150 700 50]; bubblechart3(x,y,z,sz)
座標やバブルのサイズが異なる複数のバブル セット	複数のデータ セットのプロットでは x、y、z の少なくとも 1 つが行列	行列 x、y、または z と同じサイズの行列	x をベクトル、y、z、sz を行列として指定します。 x = [1 2 3 4]; y = [1 6; 3 8; 2 7; 4 9]; z = [10 11; 12 13; 14 15; 16 17]; sz = [80 30; 150 900; 50 2000; 200 350]; bubblechart3(x,y,z,sz)
すべての座標が共通で、サイズはデータ セットごとに異なる複数のバブル セット	同じ長さのベクトル	少なくとも 1 つの次元が x、y、および z の長さと一致する行列	x、y、z をベクトル、sz を行列として指定します。 x = [1 2 3 4]; y = [5 6 7 8]; z = [9 10 11 12]; sz = [80 30; 150 900; 50 500; 200 350]; bubblechart3(x,y,z,sz)
少なくとも 1 つの次元で座標が異なるが、サイズはデータ セット間で共通である複数のバブル セット	複数のデータ セットのプロットでは x、y、z の少なくとも 1 つが行列	各データ セットのバブルと同じ数の要素をもつベクトル	x をベクトル、y と z を行列、sz をベクトルとして指定します。 x = [1 2 3 4]; y = [1 6; 3 8; 2 7; 4 9]; z = [2 8; 3 10; 4 7; 4 12]; sz = [80 150 200 350]; bubblechart3(x,y,z,sz)

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

c — バブルの色

[0 0.4470 0.7410] (既定値) | 色名 | RGB 3 成分 | RGB 3 成分の行列 | カラーマップ インデックスのベクトル

バブルの色。色名、RGB 3 成分、RGB 3 成分の行列、またはカラーマップ インデックスのベクトルとして指定します。

• 色名 — "red" のような色名、または "r" のような省略名。

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

• RGB 3 成分の行列 — 各行が RGB 3 成分である 3 列の行列。

• カラーマップ インデックスのベクトル — x、y、および z の各ベクトルと同じ長さの数値のベクトル。

色を指定する方法は、目的の配色や 1 つのバブル セットをプロットするか複数のバブル セットをプロットするかによって異なります。次の表では、最も一般的な状況について説明します。

配色	色の指定方法	例
すべてのバブルに 1 つの色を使用する。	次の表のいずれかの色名または省略名を指定するか、1 つの RGB 3 成分を指定します。	1 つのバブル セットを表示し、色を "red" に指定します。 x = [1 2 3 4]; y = [2 5 3 6]; z = [10 6 4 7]; sz = [1 2 3 4]; bubblechart3(x,y,z,sz,"red") 2 つのバブル セットを表示し、RGB 3 成分 [1 0 0] を使用して色を赤に指定します。 x = [1 2 3 4]; y = [2 5 3 6]; z = [2 5; 1 2; 8 4; 7 9]; sz = [1 2; 3 4; 5 6; 7 8]; bubblechart3(x,y,z,sz,[1 0 0])
カラーマップを使用して各バブルに異なる色を割り当てる。	数値の行ベクトルまたは列ベクトルを指定します。数値は現在のカラーマップ配列にマッピングされます。最小値はカラーマップの最初の行にマッピングされ、最大値は最後の行にマッピングされます。中間の値は中間の行に線形にマッピングされます。 チャートにバブルが 3 つある場合、値が必ずカラーマップ インデックスとして解釈されるように列ベクトルを指定します。 この方法は、x、y、z、および sz がいずれもベクトルである場合にのみ使用できます。	4 つのカラーマップ インデックスを指定するベクトル c を作成します。現在のカラーマップの色を使用して 4 個のバブルを表示します。その後、カラーマップを winter に変更します。 c = [1 2 3 4]; x = [1 2 3 4]; y = [5 6 7 8]; z = [7 8 9 10]; sz = [1 2 3 4]; bubblechart3(x,y,z,sz,c) colormap(gca,"winter")
バブルごとにカスタム色を作成する。	m 行 3 列の RGB 3 成分の行列を指定します (m はバブルの数)。 この方法は、x、y、z、および sz がいずれもベクトルである場合にのみ使用できます。	緑、赤、グレー、および紫の RGB 3 成分を指定する行列 c を作成します。次に、その色を使用してバブル チャートを作成します。 c = [0 1 0; 1 0 0; 0.5 0.5 0.5; 0.6 0 1]; x = [1 2 3 4]; y = [5 6 7 8]; z = [7 8 9 10]; sz = [1 2 3 4]; bubblechart3(x,y,z,sz,c)
データ セットごとに異なる色を作成する。	n 行 3 列の RGB 3 成分の行列を指定します (n はデータ セットの数)。 この方法は、x、y、z、sz の少なくとも 1 つが行列である場合にのみ使用できます。	2 つの RGB 3 成分を含む行列 c を作成します。次に、その色を使用して 2 つのバブル セットを表示します。 c = [1 0 0; 0.6 0 1]; x = [1 2 3 4]; y = [5 6 7 8]; z = [2 5; 1 2; 8 4; 11 9]; sz = [1 1; 2 2; 3 3; 4 4]; bubblechart3(x,y,z,sz,c)

一般的な色の色名と RGB 3 成分

色名	省略名	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"

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"

tbl — ソース table

table | timetable

プロットするデータが含まれるソース table。table または timetable として指定します。

xvar — x 座標を含む table 変数

1 つ以上の table 変数インデックス

x 座標を含む table 変数。1 つ以上の table 変数インデックスとして指定します。

table インデックスの指定

以下のいずれかのインデックス方式を使用して、目的の変数を 1 つ以上指定します。

インデックス方式	例
変数名: string、文字ベクトル、または cell 配列。 pattern オブジェクト。	"A" または 'A' — A という名前の変数 ["A","B"] または {'A','B'} — A および B という名前の 2 つの変数 "Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 数値のベクトル。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。	3 — table の 3 番目の変数 [2 3] — table の 2 番目と 3 番目の変数 [false false true] — 3 番目の変数
変数の型: 指定した型の変数を選択する vartype 添字。	vartype("categorical") — categorical 値を含んでいるすべての変数

データのプロット

指定する table 変数には、数値、categorical 値、datetime 値、または duration 値を含めることができます。

1 つのデータ セットをプロットするには、xvar、yvar、zvar、sizevar、およびオプションの cvar にそれぞれ 1 つの変数を指定します。たとえば、Patients.xls を table tbl に読み取ります。変数 Height、Weight、および Diastolic をプロットし、変数 Age に応じてバブル サイズを変化させます。

tbl = readtable('Patients.xls');
bubblechart3(tbl,'Height','Weight','Diastolic','Age')

複数のデータ セットをまとめてプロットするには、xvar、yvar、zvar、sizevar、またはオプションの cvar の少なくとも 1 つに複数の変数を指定します。複数の引数に複数の変数を指定する場合、変数の数はそれらの各引数で同じでなければなりません。

たとえば、変数 Weight を x 軸に、変数 Height を y 軸に、変数 Systolic および Diastolic を z 軸にプロットします。変数 Age をバブル サイズに指定します。

bubblechart3(tbl,'Weight','Height',{'Systolic','Diastolic'},'Age')

table 変数に対して異なるインデックス方式を使用することもできます。たとえば、xvar と xvar を変数名、zvar をインデックス番号、sizevar を logical ベクトルとして指定します。

bubblechart3(tbl,'Height','Weight',9,[false false true])

yvar — y 座標を含む table 変数

1 つ以上の table 変数インデックス

y 座標を含む table 変数。1 つ以上の table 変数インデックスとして指定します。

table インデックスの指定

以下のいずれかのインデックス方式を使用して、目的の変数を 1 つ以上指定します。

インデックス方式	例
変数名: string、文字ベクトル、または cell 配列。 pattern オブジェクト。	"A" または 'A' — A という名前の変数 ["A","B"] または {'A','B'} — A および B という名前の 2 つの変数 "Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 数値のベクトル。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。	3 — table の 3 番目の変数 [2 3] — table の 2 番目と 3 番目の変数 [false false true] — 3 番目の変数
変数の型: 指定した型の変数を選択する vartype 添字。	vartype("categorical") — categorical 値を含んでいるすべての変数

データのプロット

指定する table 変数には、数値、categorical 値、datetime 値、または duration 値を含めることができます。

1 つのデータ セットをプロットするには、xvar、yvar、zvar、sizevar、およびオプションの cvar にそれぞれ 1 つの変数を指定します。たとえば、Patients.xls を table tbl に読み取ります。変数 Height、Weight、および Diastolic をプロットし、変数 Age に応じてバブル サイズを変化させます。

tbl = readtable('Patients.xls');
bubblechart3(tbl,'Height','Weight','Diastolic','Age')

複数のデータ セットをまとめてプロットするには、xvar、yvar、zvar、sizevar、またはオプションの cvar の少なくとも 1 つに複数の変数を指定します。複数の引数に複数の変数を指定する場合、変数の数はそれらの各引数で同じでなければなりません。

たとえば、変数 Weight を x 軸に、変数 Height を y 軸に、変数 Systolic および Diastolic を z 軸にプロットします。変数 Age をバブル サイズに指定します。

bubblechart3(tbl,'Weight','Height',{'Systolic','Diastolic'},'Age')

table 変数に対して異なるインデックス方式を使用することもできます。たとえば、xvar と xvar を変数名、zvar をインデックス番号、sizevar を logical ベクトルとして指定します。

bubblechart3(tbl,'Height','Weight',9,[false false true])

zvar — z 座標を含む table 変数

1 つ以上の table 変数インデックス

z 座標を含む table 変数。1 つ以上の table 変数インデックスとして指定します。

table インデックスの指定

以下のいずれかのインデックス方式を使用して、目的の変数を 1 つ以上指定します。

インデックス方式	例
変数名: string、文字ベクトル、または cell 配列。 pattern オブジェクト。	"A" または 'A' — A という名前の変数 ["A","B"] または {'A','B'} — A および B という名前の 2 つの変数 "Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 数値のベクトル。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。	3 — table の 3 番目の変数 [2 3] — table の 2 番目と 3 番目の変数 [false false true] — 3 番目の変数
変数の型: 指定した型の変数を選択する vartype 添字。	vartype("categorical") — categorical 値を含んでいるすべての変数

データのプロット

指定する table 変数には、数値、categorical 値、datetime 値、または duration 値を含めることができます。

1 つのデータ セットをプロットするには、xvar、yvar、zvar、sizevar、およびオプションの cvar にそれぞれ 1 つの変数を指定します。たとえば、Patients.xls を table tbl に読み取ります。変数 Height、Weight、および Diastolic をプロットし、変数 Age に応じてバブル サイズを変化させます。

tbl = readtable('Patients.xls');
bubblechart3(tbl,'Height','Weight','Diastolic','Age')

複数のデータ セットをまとめてプロットするには、xvar、yvar、zvar、sizevar、またはオプションの cvar の少なくとも 1 つに複数の変数を指定します。複数の引数に複数の変数を指定する場合、変数の数はそれらの各引数で同じでなければなりません。

たとえば、変数 Weight を x 軸に、変数 Height を y 軸に、変数 Systolic および Diastolic を z 軸にプロットします。変数 Age をバブル サイズに指定します。

bubblechart3(tbl,'Weight','Height',{'Systolic','Diastolic'},'Age')

table 変数に対して異なるインデックス方式を使用することもできます。たとえば、xvar と xvar を変数名、zvar をインデックス番号、sizevar を logical ベクトルとして指定します。

bubblechart3(tbl,'Height','Weight',9,[false false true])

sizevar — バブル サイズの table 変数

1 つ以上の table 変数インデックス

バブル サイズ データを含む table 変数。1 つ以上の table 変数インデックスとして指定します。

table インデックスの指定

以下のいずれかのインデックス方式を使用して、目的の変数を 1 つ以上指定します。

インデックス方式	例
変数名: string、文字ベクトル、または cell 配列。 pattern オブジェクト。	"A" または 'A' — A という名前の変数 ["A","B"] または {'A','B'} — A および B という名前の 2 つの変数 "Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 数値のベクトル。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。	3 — table の 3 番目の変数 [2 3] — table の 2 番目と 3 番目の変数 [false false true] — 3 番目の変数
変数の型: 指定した型の変数を選択する vartype 添字。	vartype("categorical") — categorical 値を含んでいるすべての変数

データのプロット

指定する table 変数には、任意の型の数値を含めることができます。

1 つのデータ セットをプロットする場合は、sizevar に 1 つの変数を指定します。たとえば、Patients.xls を table tbl に読み取ります。変数 Height、Weight、および Diastolic をプロットし、変数 Age に応じてバブル サイズを変化させます。

tbl = readtable('Patients.xls');
bubblechart3(tbl,'Height','Weight','Diastolic','Age')

複数のデータ セットをプロットする場合は、xvar、yvar、zvar、sizevar、またはオプションの cvar の少なくとも 1 つに複数の変数を指定できます。複数の引数に複数の変数を指定する場合、変数の数はそれらの各引数で同じでなければなりません。

たとえば、変数 Weight を x 軸に、変数 Height を y 軸に、変数 Age を z 軸にプロットします。変数 Systolic および Diastolic をバブル サイズに指定します。結果のプロットには 2 組のバブルが表示されます。座標は同じですが、バブル サイズは異なります。

bubblechart3(tbl,'Weight','Height','Age',{'Systolic','Diastolic'})

cvar — バブルの色の table 変数

1 つ以上の table 変数インデックス

バブルの色データを含む table 変数。1 つ以上の table 変数インデックスとして指定します。

table インデックスの指定

以下のいずれかのインデックス方式を使用して、目的の変数を 1 つ以上指定します。

インデックス方式	例
変数名: string、文字ベクトル、または cell 配列。 pattern オブジェクト。	"A" または 'A' — A という名前の変数 ["A","B"] または {'A','B'} — A および B という名前の 2 つの変数 "Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 数値のベクトル。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。	3 — table の 3 番目の変数 [2 3] — table の 2 番目と 3 番目の変数 [false false true] — 3 番目の変数
変数の型: 指定した型の変数を選択する vartype 添字。	vartype("categorical") — categorical 値を含んでいるすべての変数

データのプロット

指定する table 変数には、任意の数値型の値を含めることができます。各変数は次のいずれかになります。

• 現在のカラーマップに線形にマッピングされる数値の列。

• RGB 3 成分の 3 列配列。RGB 3 成分は、各値が特定の色の赤、緑、青成分の強度を指定する 3 要素ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば、[0.5 0.7 1] では薄い青の色調が指定されます。

1 つのデータ セットをプロットする場合は、cvar に 1 つの変数を指定します。たとえば、7 つの乱数の変数をもつ table を作成します。変数 X1、Y、および Z をプロットします。変数 SZ に応じてバブル サイズを変化させ、変数 Color1 に応じて色を変化させます。

tbl = table(randn(50,1)-10,randn(50,1)+10,rand(50,1), ...
  rand(50,1),rand(50,1),rand(50,1),rand(50,1),...
  'VariableNames',{'X1','X2','Y','Z','SZ','Color1','Color2'});

bubblechart3(tbl,'X1','Y','Z','SZ','Color1')

複数のデータ セットをプロットする場合は、xvar、yvar、zvar、sizevar、または cvar の少なくとも 1 つに複数の変数を指定できます。複数の引数に複数の変数を指定する場合、変数の数はそれらの各引数で同じでなければなりません。

たとえば、変数 X1 および X2 を x 軸に、変数 Y を y 軸に、変数 Z を z 軸にプロットします。変数 SZ に応じてバブル サイズを変化させます。変数 Color1 および Color2 を色に指定します。結果のプロットには 2 組のバブルが表示されます。y 座標、z 座標、およびバブル サイズは同じですが、x 座標と色は異なります。

bubblechart3(tbl,{'X1','X2'},'Y','Z','SZ',{'Color1','Color2'})

ax — ターゲット座標軸

Axes オブジェクト

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

名前と値の引数

引数のオプションのペアを Name1=Value1,...,NameN=ValueN として指定します。ここで Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name を引用符で囲みます。

例: bubblechart3([2 1 5],[4 10 9],[1 2 3],[1 2 3],'MarkerFaceColor','red') は、赤のバブルを作成します。

メモ

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

MarkerEdgeColor — マーカーの輪郭の色

"flat" (既定値) | RGB 3 成分 | 16 進数カラー コード | "r" | "g" | "b" | ...

マーカーの輪郭の色。"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"

例: [0.5 0.5 0.5]

例: "blue"

例: "#D2F9A7"

MarkerFaceColor — マーカーの塗りつぶし色

'flat' (既定値) | 'auto' | 'none' | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

マーカーの塗りつぶし色。'flat'、'auto'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。'flat' オプションは CData 値を使用します。'auto' オプションは座標軸の Color プロパティと同じ色を使用します。

カスタム色を使用する場合は、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"

例: [0.3 0.2 0.1]

例: 'green'

例: '#D2F9A7'

LineWidth — マーカー エッジの幅

0.5 (既定値) | 正の値

マーカー エッジの幅。ポイント単位の正の値として指定します。

例: 0.75

MarkerEdgeAlpha — マーカーのエッジの透明度

1 (既定値) | 範囲 [0,1] のスカラー | 'flat'

マーカーのエッジの透明度。[0,1] の範囲のスカラーまたは 'flat' として指定します。値 1 は不透明、値 0 は完全な透明を表します。0 と 1 の間の値は半透明です。

プロット内の点ごとにエッジの透明度を異なる値に設定するには、AlphaData プロパティを XData プロパティと同じサイズのベクトルに設定し、MarkerEdgeAlpha プロパティを 'flat' に設定します。

MarkerFaceAlpha — マーカーの面の透明度

0.6 (既定値) | 範囲 [0,1] のスカラー | 'flat'

マーカーの面の透明度。[0,1] の範囲のスカラーまたは 'flat' として指定します。値 1 は不透明、値 0 は完全な透明を表します。0 と 1 の間の値は一部透明です。

点ごとにマーカー面の透明度を異なる値に設定するには、AlphaData プロパティを XData プロパティと同じサイズのベクトルに設定し、MarkerFaceAlpha プロパティを 'flat' に設定します。

バージョン履歴

R2020b で導入

R2022b: table で作成したプロットが軸ラベルと凡例ラベルに特殊文字を保持

関数 bubblechart3 に 1 つの table と 1 つ以上の変数名を渡した場合に、table 変数名に含めた特殊文字 (アンダースコアなど) が軸ラベルと凡例ラベルに表示されるようになりました。以前は、特殊文字は TeX または LaTeX の文字として解釈されていました。

たとえば、Sample_Number という名前の変数を含む table を関数 bubblechart3 に渡すと、軸ラベルと凡例ラベルにアンダースコアが表示されます。R2022a 以前のリリースでは、アンダースコアは下付き文字として解釈されます。

リリース	table 変数 "Sample_Number" のラベル
R2022b
R2022a

軸ラベルと凡例ラベルを TeX または LaTeX の書式設定で表示するには、ラベルを手動で指定します。たとえば、プロット後に、目的のラベル文字列を指定して関数 xlabel または関数 legend を呼び出します。

xlabel("Sample_Number")
legend(["Sample_Number" "Another_Legend_Label"])

R2022a: 行列を使用して複数のデータ セットを同時にプロット

関数 bubblechart3 で座標とサイズ データのベクトルと行列の組み合わせを使用できるようになりました。これにより、プロット コマンド間で関数 hold を使用しなくても、複数のデータ セットを同時に可視化できます。

R2021b: table を直接 bubblechart3 に渡す

table を関数 bubblechart3 に渡し、その後にプロット対象の変数を渡すことで、プロットを作成します。データを table として指定すると、軸ラベルと凡例 (存在する場合) に table 変数名を使用して自動的にラベルが付けられます。

参考

関数

• bubblechart | bubblelim | bubblesize | bubblelegend

プロパティ

• BubbleChart のプロパティ

トピック

• table をサポートするプロット