Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

bubblechart

バブル チャート

R2020b 以降

  • Bubble chart

説明

ベクトルと行列のデータ

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

  • 1 つの座標セットをプロットするには、xysz を等しい長さのベクトルとして指定します。

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

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

テーブル データ

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

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

追加オプション

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

bubblechart(___,Name,Value) は、1 つ以上の名前と値の引数を使用して、BubbleChart プロパティを指定します。プロパティは他のすべての入力引数の後に指定します。プロパティの一覧については、BubbleChart のプロパティ を参照してください。

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

すべて折りたたむ

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

x = 1:20;
y = rand(1,20);
sz = rand(1,20);
bubblechart(x,y,sz);

Figure contains an axes object. The axes object contains an object of type bubblechart.

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

x = 1:20;
y = rand(1,20);
sz = rand(1,20);
bubblechart(x,y,sz,'red');

Figure contains an axes object. The axes object contains an object of type bubblechart.

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

bubblechart(x,y,sz,'#7031BB');

Figure contains an axes object. The axes object contains an object of type bubblechart.

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

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

Figure contains an axes object. The axes object contains an object of type bubblechart.

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

x = 1:20;
y = rand(1,20);
sz = rand(1,20);
bubblechart(x,y,sz);

Figure contains an axes object. The axes object contains an object of type bubblechart.

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

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

Figure contains an axes object. The axes object contains an object of type bubblechart.

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

bc.MarkerEdgeColor = [0.5 0 0.5];

Figure contains an axes object. The axes object contains an object of type bubblechart.

都市圏のさまざまな都市における特定の毒素の汚染レベルを示すデータセットを定義します。towns を各都市の人口として定義します。nsites を対応する都市内の産業用地の数として定義します。levels を都市の汚染レベルとして定義します。次に、座標軸ラベルを使用してバブル チャートにデータを表示します。関数 bubblesize を呼び出してバブル サイズを小さくし、バブル サイズと人口の関係を示すバブル凡例を追加します。

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

% Display bubble chart with axis labels and legend
bubblechart(nsites,levels,towns)
xlabel('Number of Industrial Sites')
ylabel('Contamination Level')
bubblesize([5 30])
bubblelegend('Town Population','Location','eastoutside')

Figure contains an axes object and an object of type bubblelegend. The axes object contains an object of type bubblechart.

同じ座標軸に複数のデータ セットを表示する場合、複数の凡例を含めることができます。凡例の配置を管理するには、タイル表示チャート レイアウトでチャートを作成します。

2 組のデータセットを作成し、タイル表示チャート レイアウト内の同じ axes オブジェクトにそれらをまとめてプロットします。

x = 1:20;
y1 = rand(1,20);
y2 = rand(1,20);
sz1 = randi([20 500],[1,20]);
sz2 = randi([20 500],[1,20]);

% Plot data in a tiled chart layout
t = tiledlayout(1,1);
nexttile
bubblechart(x,y1,sz1)
hold on
bubblechart(x,y2,sz1)
hold off

Figure contains an axes object. The axes object contains 2 objects of type bubblechart.

バブルのサイズを示すバブル凡例を追加し、色を示す別の凡例を追加します。戻り引数を指定して関数 bubblelegend および legend を呼び出し、各 legend オブジェクトを格納します。各オブジェクトの Layout.Tile プロパティを 'east' に設定して、タイル表示チャート レイアウトの右外側に汎用を移動します。

blgd = bubblelegend('Population');
lgd = legend('Springfield','Fairview');
blgd.Layout.Tile = 'east';
lgd.Layout.Tile = 'east';

Figure contains an axes object. The axes object contains 2 objects of type bubblechart. These objects represent Springfield, Fairview.

table のデータをプロットするには、table を関数 bubblechart に渡してプロット対象の変数を指定すると便利です。たとえば、patients.xls を table tbl として読み取ります。tbl を最初の引数として関数 bubblechart に渡し、続けて変数名を渡すことにより、変数 SystolicDiastolic、および Weight をプロットします。既定では、軸ラベルは変数名と一致します。

tbl = readtable('patients.xls');
bubblechart(tbl,'Systolic','Diastolic','Weight');

Figure contains an axes object. The axes object contains an object of type bubblechart.

また、複数の変数を同時にプロットできます。たとえば、yvar 引数を cell 配列 {'Systolic','Diastolic'} として指定することにより、変数 Height に対して両方の血圧変数をプロットします。バブル サイズの範囲を 520 ポイントに変更します。次に、凡例を追加します。凡例ラベルは変数名と一致します。

bubblechart(tbl,'Height',{'Systolic','Diastolic'},'Weight');
bubblesize([5 20])
legend

Figure contains an axes object. The axes object contains 2 objects of type bubblechart.

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

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

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

bubblechart(tbl,'X','Y','Sz','Colors');

Figure contains an axes object. The axes object contains an object of type bubblechart.

特定の都市圏の東側と西側にある複数の都市における特定の毒素の汚染レベルを示す 2 組のデータセットを定義します。towns1towns2 を都市における人口として定義します。nsites1nsites2 を対応する都市の産業用地の数として定義します。次に、levels1levels2 を都市の汚染レベルとして定義します。

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

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

tiledlayout(1,2,'TileSpacing','compact')

% West side
ax1 = nexttile;
bubblechart(ax1,nsites1,levels1,towns1);
title('West Side')
xlabel('Number of Industrial Sites')

% East side
ax2 = nexttile;
bubblechart(ax2,nsites2,levels2,towns2);
title('East Side')
xlabel('Number of Industrial Sites')
ylabel('Contamination Level')

Figure contains 2 axes objects. Axes object 1 with title West Side contains an object of type bubblechart. Axes object 2 with title East Side contains an object of type bubblechart.

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

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

Figure contains 2 axes objects. Axes object 1 with title West Side contains an object of type bubblechart. Axes object 2 with title East Side contains an object of type bubblechart.

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

% Adjust scale of the bubbles
alltowns = [towns1 towns2];
newlims = [min(alltowns) max(alltowns)];
bubblelim(ax1,newlims)
bubblelim(ax2,newlims)

% Adjust x-axis limits
allx = [xlim(ax1) xlim(ax2)];
xmin = min(allx);
xmax = max(allx);
xlim([ax1 ax2],[xmin xmax]);

% Adjust y-axis limits
ally = [ylim(ax1) ylim(ax2)];
ymin = min(ally);
ymax = max(ally);
ylim([ax1 ax2],[ymin ymax]);

Figure contains 2 axes objects. Axes object 1 with title West Side contains an object of type bubblechart. Axes object 2 with title East Side contains an object of type bubblechart.

入力引数

すべて折りたたむ

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

バブル チャートのタイプ座標の指定方法
1 つのバブル

xy、および sz をスカラーとして指定します。以下に例を示します。

bubblechart(1,2,10)

1 つのバブル セット

xy、および sz を同じ長さの行ベクトルまたは列ベクトルの任意の組み合わせとして指定します。以下に例を示します。

x = [1 2 3 4];
y = [4; 5; 6; 7];
sz = [12 13 14 15];
bubblechart(x,y,sz)

複数のバブル セット

すべてのデータ セットが同じ x 座標または y 座標を共有している場合は、共有している座標をベクトルとして、その他の座標を行列として指定します。ベクトルの長さは行列の次元の 1 つと一致していなければなりません。たとえば、同じ x 座標とサイズの値を共有する 2 つのデータセットをプロットします。

x = [1 2 3 4];
y = [4 5 6 7; 7 8 9 10];
sz = [1 2 3 4];
bubblechart(x,y,sz)
行列が正方の場合、bubblechart は行列の列ごとに別個のバブルのセットをプロットします。

あるいは、xysz を等サイズの行列として指定します。この場合、bubblechart は行列の各列をプロットします。たとえば、2 つのデータセットをプロットします。

x = [1 1; 2 2; 3 3; 4 4];
y = [4 7; 5 8; 6 9; 7 10];
sz = [1 1; 2 2; 3 3; 4 4];
bubblechart(x,y,sz)

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

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

バブル チャートのタイプ座標の指定方法
1 つのバブル

xy、および sz をスカラーとして指定します。以下に例を示します。

bubblechart(1,2,10)

1 つのバブル セット

xy、および sz を同じ長さの行ベクトルまたは列ベクトルの任意の組み合わせとして指定します。以下に例を示します。

x = [1 2 3 4];
y = [4; 5; 6; 7];
sz = [12 13 14 15];
bubblechart(x,y,sz)

複数のバブル セット

すべてのデータ セットが同じ x 座標または y 座標を共有している場合は、共有している座標をベクトルとして、その他の座標を行列として指定します。ベクトルの長さは行列の次元の 1 つと一致していなければなりません。たとえば、同じ x 座標とサイズの値を共有する 2 つのデータセットをプロットします。

x = [1 2 3 4];
y = [4 5 6 7; 7 8 9 10];
sz = [1 2 3 4];
bubblechart(x,y,sz)
行列が正方の場合、bubblechart は行列の列ごとに別個のバブルのセットをプロットします。

あるいは、xysz を等サイズの行列として指定します。この場合、bubblechart は行列の各列をプロットします。たとえば、2 つのデータセットをプロットします。

x = [1 1; 2 2; 3 3; 4 4];
y = [4 7; 5 8; 6 9; 7 10];
sz = [1 1; 2 2; 3 3; 4 4];
bubblechart(x,y,sz)

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

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

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

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

バブル チャートのタイプxy sz

1 つのバブル セット

同じ長さのベクトル

x および y と同じ長さのベクトル

xy、および sz をベクトルとして指定します。

x = [1 2 3 4];
y = [4 5 6 7];
sz = [80 150 700 50];
bubblechart(x,y,sz)

座標やバブルのサイズが異なる複数のバブル セット

複数のデータセットをプロットする場合は x または y の少なくとも一方が行列

x または y の行列と同じサイズの行列

x をベクトル、y および sz を行列として指定します。

x = [1 2 3 4];
y = [1 6; 3 8; 2 7; 4 9];
sz = [80 30; 150 900; 50 2000; 200 350];
bubblechart(x,y,sz)

すべての座標が共通で、サイズはデータ セットごとに異なる複数のバブル セット

同じ長さのベクトル

少なくとも 1 つの次元が x および y の長さと一致する行列

xy をベクトル、sz を行列として指定します。

x = [1 2 3 4];
y = [5 6 7 8];
sz = [80 30; 150 900; 50 500; 200 350];
bubblechart(x,y,sz)

少なくとも 1 つの次元で座標が異なるが、サイズはデータセット間で共通である複数のバブル セット

複数のデータセットをプロットする場合は x または y の少なくとも一方が行列

各データ セットのバブルと同じ数の要素をもつベクトル

x をベクトル、y を行列、sz をベクトルとして指定します。

x = [1 2 3 4];
y = [1 6; 3 8; 2 7; 4 9];
sz = [80 150 200 350];
bubblechart(x,y,sz)

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

バブルの色。色名、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 のベクトルと同じ長さの数値のベクトル。

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

配色色の指定方法

すべてのバブルに 1 つの色を使用する。

次の表のいずれかの色名または省略名を指定するか、1 つの RGB 3 成分を指定します。

1 つのバブル セットを表示し、色を "red" に指定します。

x = [1 2 3 4];
y = [2 5 3 6];
sz = [1 2 3 4];
bubblechart(x,y,sz,"red")

2 つのバブル セットを表示し、RGB 3 成分 [1 0 0] を使用して色を赤に指定します。

x = [1 2 3 4];
y = [2 5; 1 2; 8 4; 7 9];
sz = [1 2; 3 4; 5 6; 7 8];
bubblechart(x,y,sz,[1 0 0])

カラーマップを使用して各バブルに異なる色を割り当てる。

数値の行ベクトルまたは列ベクトルを指定します。数値は現在のカラーマップ配列にマッピングされます。最小値はカラーマップの最初の行にマッピングされ、最大値は最後の行にマッピングされます。中間の値は中間の行に線形にマッピングされます。

チャートにバブルが 3 つある場合、値が必ずカラーマップ インデックスとして解釈されるように列ベクトルを指定します。

この方法は、xy、および sz がいずれもベクトルである場合にのみ使用できます。

4 つのカラーマップ インデックスを指定するベクトル c を作成します。現在のカラーマップの色を使用して 4 個のバブルを表示します。その後、カラーマップを winter に変更します。

c = [1 2 3 4];
x = [1 2 3 4];
y = [5 6 7 8];
sz = [1 2 3 4];
bubblechart(x,y,sz,c)
colormap(gca,"winter")

バブルごとにカスタム色を作成する。

m 行 3 列の RGB 3 成分の行列を指定します (m はバブルの数)。

この方法は、xy、および sz がいずれもベクトルである場合にのみ使用できます。

緑、赤、グレー、および紫の RGB 3 成分を指定する行列 c を作成します。次に、その色を使用して 4 つのバブルを表示します。

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];
sz = [1 2 3 4];
bubblechart(x,y,sz,c)

データセットごとに異なる色を作成する。

n 行 3 列の RGB 3 成分の行列を指定します (n はデータセットの数)。

この方法は、xy、または sz の少なくとも 1 つが行列である場合にのみ使用できます。

2 つの RGB 3 成分を含む行列 c を作成します。次に、その色を使用して 2 つのバブル セットを表示します。

c = [1 0 0; 0.6 0 1];
x = [1 2 3 4];
y = [2 5; 1 2; 8 4; 11 9];
sz = [1 1; 2 2; 3 3; 4 4];
bubblechart(x,y,sz,c)

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

色名省略名RGB 3 成分16 進数カラー コード外観
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

MATLAB® の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

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

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

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

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

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

bubblechart(tbl,'Weight',{'Systolic','Diastolic'},'Age')

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

bubblechart(tbl,'Height',6,[false false true])

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

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

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

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

bubblechart(tbl,'Weight',{'Systolic','Diastolic'},'Age')

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

bubblechart(tbl,'Height',6,[false false true])

バブル サイズ データを含む 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 をプロットし、変数 Age に応じてバブル サイズを変化させます。

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

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

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

bubblechart(tbl,'Weight','Height',{'Systolic','Diastolic'})

バブルの色データを含む 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 つの変数を指定します。たとえば、6 つの乱数の変数をもつ table を作成します。変数 X1 および Y をプロットします。変数 SZ に応じてバブル サイズを変化させ、変数 Color1 に応じて色を変化させます。

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

bubblechart(tbl,'X1','Y','SZ','Color1')

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

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

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

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

名前と値の引数

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

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

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

メモ

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

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

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"該当なし該当なし該当なし色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

例: [0.5 0.5 0.5]

例: "blue"

例: "#D2F9A7"

マーカーの塗りつぶし色。'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"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"該当なし該当なし該当なし色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

例: [0.3 0.2 0.1]

例: 'green'

例: '#D2F9A7'

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

例: 0.75

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

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

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

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

バージョン履歴

R2020b で導入

すべて展開する