Main Content

bubblelegend

为气泡图创建图例

自 R2020b 起

全页折叠

    语法

    bubblelegend
    bubblelegend(titletext)
    bubblelegend(___,Name,Value)
    bubblelegend(ax,___)
    blgd = bubblelegend(___)

    说明

    bubblelegend 在当前坐标区中创建一个气泡图例。气泡图例有助于显示使用 bubblechart、bubblechart3 和 polarbubblechart 函数创建的图中气泡与大小数据之间的关系。

    示例

    bubblelegend(titletext) 指定图例的标题。将 titletext 指定为字符向量、字符向量元胞数组或字符串数组。

    示例

    bubblelegend(___,Name,Value) 使用一个或多个名称-值对组参数来设置气泡图例属性。在所有其他输入参数后指定属性。

    bubblelegend(ax,___) 在指定的目标坐标区 ax 中创建图例。在指定所有其他输入参数之前指定坐标区。

    示例

    blgd = bubblelegend(___) 返回 BubbleLegend 对象。创建图例后，使用 blgd 修改图例的属性。有关属性列表，请参阅 BubbleLegend 属性。

    示例

    全部折叠

    打开实时脚本

    创建气泡图并添加气泡图例。

    x = 1:10;
y = exp(-0.5*x) +  .05 * randn(1,10);
sz = randi([20 500],[1,10]);
bubblechart(x,y,sz)
bubblelegend('Population')

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

    打开实时脚本

    创建气泡图并添加气泡图例。指定 'telescopic' 样式，使显示更加紧凑。

    x = 1:15;
y = exp(-0.5*x) +  .1 * randn(1,15);
sz = randi([20 500],[1,15]);
bubblechart(x,y,sz)
bubblelegend('Population','Style','telescopic');

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

    打开实时脚本

    创建一个气泡图。然后调用带返回参数的 bubblelegend 函数，以将 BubbleLegend 对象存储为 blgd。通过将对象的 Location 属性设置为 'northeastoutside'，将图例移出图框。通过将 NumBubbles 属性设置为 2，显示两个而不是三个气泡。

    x = 1:50;
y = rand(1,50);
sz = randi([20 500],[1,50]);
bubblechart(x,y,sz)

% Create bubble legend and set properties
blgd = bubblelegend('Population');
blgd.Location = 'northeastoutside';
blgd.NumBubbles = 2;

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

    打开实时脚本

    当使用不同颜色或不同类型的绘图对象显示多个数据集时，可以包含多个图例。要管理图例的对齐，请在分块图布局中创建图。

    创建两个数据集，并将它们绘制在分块图布局内的同一坐标区对象中。 

    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 函数来存储图例对象。通过将每个对象的 Layout.Tile 属性设置为 'east'，将图例移至 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.

    输入参数

    全部折叠

    标题文本，指定为字符向量、字符向量元胞数组或字符串数组。要创建一个多行标题，请指定字符向量元胞数组或字符串数组。

    示例： bubblelegend('My Legend')

    目标坐标区，指定为 Axes、PolarAxes 或 GeographicAxes 对象。如果未指定坐标区，则 MATLAB® 将在当前坐标区中进行绘制；或如果不存在 Axes 对象，则创建一个对象。

    名称-值参数

    将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参数名称，Value 是对应的值。名称-值参数必须出现在其他参数之后，但参数对组的顺序无关紧要。

    在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

    示例： bubblelegend('Style','telescopic') 创建一个嵌套图例。

    注意

    此处所列的属性只是一部分。有关完整列表，请参阅 BubbleLegend 属性。

    相对于坐标区的位置，指定为下表中所列的位置值之一。

    值描述
    'north'坐标区内侧上边缘。
    'south'坐标区内侧下边缘。
    'east'坐标区内侧右边缘。
    'west'坐标区内侧左边缘。
    'northeast'坐标区内侧右上角。
    'northwest'坐标区内的左上角。
    'southeast'坐标区内的右下角。
    'southwest'坐标区内的左下角。
    'northoutside'坐标区的上方。
    'southoutside'坐标区的下方。
    'eastoutside'到坐标区的右侧。
    'westoutside'到坐标区的左侧。
    'northeastoutside'坐标区外的右上角。
    'northwestoutside'坐标区外的左上角。
    'southeastoutside'坐标区外的右下角。
    'southwestoutside'坐标区外的左下角
    'layout'分块图布局中的图块。要将图例移至不同图块，请设置 Layout 属性。
    'none'由 Position 属性确定的位置。可使用 Position 属性指定自定义位置。

    图例样式，指定为表中的值之一。表中的图像显示一个具有三个气泡的图例采用不同样式时的外观。

    样式值外观
    'vertical'

    Vertical style legend with three bubbles.

    'horizontal'

    Horizontal style legend with three bubbles.

    'telescopic'

    Telescopic style legend with three bubbles.

    图例中显示的气泡的数量，指定为 2 或 3。下表显示具有 2 个和 3 个气泡的垂直气泡图例的外观。

    NumBubbles 值外观
    2

    Vertical style legend with two bubbles.

    3

    Vertical style legend with three bubbles.

    范围标签，指定为包含两个或三个元素的字符向量元胞数组或字符串数组。第一个标签出现在图例中最小气泡的旁边，最后一个标签出现在最大气泡的旁边。如果指定三个标签，则当图例是水平的或图例只有两个气泡时，第二个标签不会显示。下表显示了一些常见情形。

    示例结果

    创建一个具有三个气泡的垂直图例，并指定三个范围标签。 

    blgd = bubblelegend;
blgd.LimitLabels = {'Shortage','Abundance','Surplus'};

    Vertical legend displaying all three labels.

    创建一个具有三个气泡的嵌套图例，并指定三个范围标签。

    blgd = bubblelegend('Style','telescopic');
blgd.LimitLabels = {'Shortage','Abundance','Surplus'};

    Telescopic legend displaying all three labels.

    创建一个具有两个气泡的垂直图例，并指定三个范围标签。

    blgd = bubblelegend('NumBubbles',2);
blgd.LimitLabels = {'Shortage','Abundance','Surplus'};

    Legend with two bubbles displaying two of the three labels.

    创建一个具有三个气泡的水平图例，并指定三个范围标签。

    blgd = bubblelegend('Style','horizontal');
blgd.LimitLabels = {'Shortage','Abundance','Surplus'};

    Horizontal legend displaying two of the three labels.

    气泡大小的顺序，指定为表中的值之一。该表显示不同值对具有三个气泡的垂直图例的影响。

    BubbleSizeOrder 值外观
    'descending'

    Vertical legend with descending order.

    'ascending'

    Vertical legend with ascending order.

    版本历史记录

    在 R2020b 中推出

    另请参阅

    函数

    属性