Main Content

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

bubblechart

    説明

    bubblechart(x,y,sz) は、ベクトル xy で指定された場所に色付きの円マーカー (バブル) を表示します。バブル サイズをベクトル sz として指定します。ベクトル xy および sz は同じ長さでなければなりません。

    bubblechart(x,y,sz,c) は、バブルの色を指定します。

    • すべてのバブルに 1 つの色を使用するには、色名、16 進数カラー コード、または RGB 3 成分を指定します。

    • 各バブルに異なる色を割り当てるには、x および y と同じ長さのベクトルを指定します。または、RGB 3 成分の 3 列の行列を指定できます。行列の行数は x および y の長さと一致していなければなりません。

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

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

    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);

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

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

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

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

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

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

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

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

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

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

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

    bc.MarkerEdgeColor = [0.5 0 0.5];

    都市圏のさまざまな都市における特定の毒素の汚染レベルを示すデータセットを定義します。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')

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

    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

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

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

    特定の都市圏の東側と西側にある複数の都市における特定の毒素の汚染レベルを示す 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')

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

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

    西側の都市は東側の都市の 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]);

    入力引数

    すべて折りたたむ

    x 座標。数値スカラーまたは y と同じ長さのベクトルとして指定します。

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

    y 座標。数値スカラーまたは x と同じ長さのベクトルとして指定します。

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

    バブルのサイズ。数値スカラーまたは x および y と同じ長さのベクトルとして指定します。

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

    バブルの色。RGB 3 成分、色名、16 進数カラー コード、RGB 3 成分の行列、またはカラーマップのインデックスのベクトルとして指定します。すべてのバブルを同じ色で表示するか、各バブルを異なる色で表示できます。既定では、バブルは一部透明色で塗りつぶされ、バブルのエッジは不透明です。

    バブルを同じ色で表示

    次のいずれかの値を指定して、すべてのバブルを同じ色で表示します。

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

    • 16 進数カラー コード — ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラー。これらの値では大文字小文字は区別されません。したがって、カラー コード '#FF8800''#ff8800''#F80'、および '#f80' は等価です。

    • 色名または省略名 — 以下の表に示す色名または省略名。

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

    バブルを異なる色で表示

    次のいずれかの値を指定して、各バブルに異なる色を割り当てます。

    • RGB 3 成分の 3 列の行列 — 行列の各行で対応するバブルの RGB 3 成分の色を指定します。各行の値は、色の赤、緑、青の成分の強度を指定します。強度値は [0,1] の範囲でなければなりません。行数は座標ベクトルの長さと等しくなければなりません。

    • カラーマップ インデックスのベクトル — 現在のカラーマップにインデックス付けする数値の m 行 1 列のベクトル。ベクトルの値は、カラーマップの全範囲に対応します。c の長さは、座標ベクトルの長さと同じでなければなりません。座標軸のカラーマップを変更するには関数 colormap を使用します。

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

    名前と値のペアの引数

    オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順序で指定できます。

    例: 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'

    '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'

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

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

    例: 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 で導入