exponenta event banner

bubblelegend

Создать легенду для пузырьковой диаграммы

    Описание

    bubblelegend создает условное обозначение пузыря в текущих осях. Легенды пузырей полезны для отображения взаимосвязи между пузырями и данными о размерах для диаграмм, создаваемых с помощью bubblechart, bubblechart3, и polarbubblechart функции.

    пример

    bubblelegend(titletext) задает заголовок легенды. Определить titletext в качестве символьного вектора, массива ячеек символьных векторов или строкового массива.

    пример

    bubblelegend(___,Name,Value) задает свойства условных обозначений пузырей, используя один или несколько аргументов пары имя-значение. Укажите свойства после всех других входных аргументов.

    bubblelegend(ax,___) создает легенду в указанных целевых осях ax. Укажите оси перед всеми другими входными аргументами.

    пример

    blgd = bubblelegend(___) возвращает значение BubbleLegend объект. Использовать blgd для изменения свойств легенды после ее создания. Список свойств см. в разделе Свойства BubureLegend.

    Примеры

    свернуть все

    Создайте пузырьковую диаграмму и добавьте условное обозначение пузыря.

    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 and an object of type bubblelegend. The axes 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 and an object of type bubblelegend. The axes contains an object of type bubblechart.

    Создайте пузырьковую диаграмму. Затем вызовите bubblelegend с возвращаемым аргументом для хранения BubbleLegend объект как blgd. Переместите легенду за пределы поля печати, установив значение Location свойство объекта to '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 and an object of type bubblelegend. The axes 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. The axes contains 2 objects of type bubblechart.

    Добавьте условное обозначение пузыря для иллюстрации размеров пузыря и еще одну условное обозначение для иллюстрации цветов. Позвоните в bubblelegend и legend функции, использующие возвращаемый аргумент для хранения объектов легенды. Переместите легенды в восточную плитку, установив значение Layout.Tile свойство каждого объекта для 'east'. Размещение легенд вместе в плитке удерживает их выровненными.

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

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

    Входные аргументы

    свернуть все

    Текст заголовка, указанный как вектор символов, массив ячеек векторов символов или строковый массив. Чтобы создать многострочный заголовок, укажите массив ячеек из символьных векторов или строковый массив.

    Пример: bubblelegend('My Legend')

    Целевые оси, указанные как Axes, PolarAxes, или GeographicAxes объект. Если оси не заданы, MATLAB ® выводит на график текущие оси или создает Axes объект, если он не существует.

    Аргументы пары «имя-значение»

    Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

    Пример: bubblelegend('Style','telescopic') создает телескопическую легенду.

    Примечание

    Перечисленные здесь свойства являются только подмножеством. Полный список см. в разделе Свойства BubureLegend.

    Расположение относительно осей, указанное как одно из значений расположения, перечисленных в этой таблице.

    СтоимостьОписание
    '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.

    Порядок размеров пузырьков, указанный в таблице как одно из значений. В таблице показано влияние различных значений на вертикальную легенду, имеющую три пузыря.

    Значение «BubureStartOrder»Внешность
    'descending'

    Vertical legend with descending order.

    'ascending'

    Vertical legend with ascending order.

    См. также

    Функции

    Свойства

    Представлен в R2020b