nested_pie

Version 3.5.0.0 (245 KB) by Moses
Create a nested pie chart with customizable text.
189 Downloads
Updated 25 Oct 2023

View nested_pie on File Exchange

nested_pie

Create a nested pie chart with customizable text.

Syntax:

nested_pie(C)

nested_pie(C, Name, Value, ...)

h = nested_pie(_)

Input Arguments:

(Required)

  • C - The data points used to plot the nested pie chart. It is a nested cell array of numerical values, starting with the inner most layer going to the outer most layer of the pie chart. [nested cell of numerical array]

Output Arguments:

(Optional)

  • h - Figure handle of pie chart. [figure object]

Name-Value Pair Arguments:

(Optional)

  • RhoLower - Used to specify the starting radius of the inner most nested pie chart. [0.2 (default) | scalar value between (0, 1)]

  • EdgeColor - Used to specify the edge color of the wedges. [black (default) | RGB triplet | hexadecimal color code]

  • LineWidth - Used to specify the edge line width of the wedges. [2 (default) | scalar value]

  • LineStyle - Used to specify edge line style of the wedges. ['-' (default) | '--' | ':' | '-.' | 'none']

  • WedgeColors - Used to specify the colors of the individual wedges. [lines colormap (default) | cell array of RGB triplets]

  • PercentStatus - Used to specify whether or not to display percentage text. [{'on'} (default) | {'off'} | cell array of percent statuses]

  • PercentPrecision- Used to specify the percentage text decimal places. [1 (default) | integer value]

  • PercentFontColor- Used to specify the percentage text font color. [white (default) | RGB triplet | hexadecimal color code]

  • PercentFontSize - Used to specify the percentage text font size. [10 (default) | scalar value]

  • PercentFontWeight- Used to specify the percentage text font weight. [bold (default) | 'normal']

  • PercentEdgeColor- Used to specify the percentage text box edge color. [none (default) | RGB triplet | hexadecimal color code]

  • PercentBackgroundColor- Used to specify the percentage text box background color. [white (default) | RGB triplet | hexadecimal color code]

  • LabelText - Used to specify the label of the outer most layer. [default text | cell array of char]

  • LabelFontSize - Used to specify the font size of the labels. [10 (default) | scalar value]

  • LabelFontColor - Used to specify the font color of the labels. [white (default) | RGB triplet | hexadecimal color code]

  • LabelFontWeight - Used to specify the font weight of the labels. [bold (default) | 'normal']

  • LabelEdgeColor - Used to specify the edge color of the labels. [none (default) | RGB triplet | hexadecimal color code]

  • LabelBackgroundColor- Used to specify the background color of the labels. [white (default) | RGB triplet | hexadecimal color code]

  • LabelRotation - Used to specify the rotation of the labels. [0 | scalar value]

  • LabelOffset - Used to specify the radial offset of the labels. [0 | scalar value]

  • LabelInterpreter- Used to specify the interpreter of the labels. ['none' | 'tex' | 'latex']

  • FillTransparency- Used to specify the fill transparency of the wedges. [scalar value between (0, 1)]

  • IgnorePercent - Used to ignore the labelling below a certain percent. Useful for small percentage to avoid clutter. [scalar value between (0, 1)]

  • LegendOrder - Used to change the order in which pie layer is displayed first in the legend. [inner to outer (default) | scalar values between(1, number of layers)]

Examples:

Example 1: Nested pie chart

% Initialize data points
inner_pie = [0.1, 0.15, 0.2, 0.05, 0.3, 0.2];
outer_pie = [0.25, 0.25, 0.5];
C = {...
    inner_pie,... % Inner to outer layer
    outer_pie};

% Spider plot
nested_pie(C,...
    'PercentStatus', {'off', 'on'});

% Title
title('Nested Pie Chart');

% Legend properties
legend_str = cell(length(inner_pie), 1);
for ii = 1:length(legend_str)
    legend_value = inner_pie(ii);
    legend_str{ii} = sprintf('Inner Pie #%i: %.1f%%', ii, legend_value*100);
end
lg =legend(legend_str, 'Location', 'eastoutside');
lg.Title.String = 'Inner Pie';

Example 2: Nested pie chart with custom colors for each wedge

% Initialize data points
inner_pie = [0.1, 0.15, 0.2, 0.05, 0.3, 0.2];
outer_pie = [0.25, 0.25, 0.5];
C = {...
    inner_pie,... % Inner to outer layer
    outer_pie};

% Custom colors
inner_colors = [...
    0 0.4470 0.7410;...
    0 0.4470 0.7410;...
    0.8500 0.3250 0.0980;...
    0.8500 0.3250 0.0980;...
    0.9290 0.6940 0.1250;...
    0.9290 0.6940 0.1250];
outer_colors = [...
    0 0.4470 0.7410;...
    0.8500 0.3250 0.0980;...
    0.9290 0.6940 0.1250];
wedge_colors = {...
    inner_colors,...
    outer_colors};

% Spider plot
nested_pie(C,...
    'WedgeColors', wedge_colors);

% Title
title('Nested Pie Chart');

Example 3: Thin pie crust

% Initialize data points
inner_pie = [0.1, 0.15, 0.2, 0.05, 0.3, 0.2];
C = {inner_pie};

% Spider plot
nested_pie(C,...
    'RhoLower', 0.7);

% Title
title('Nested Pie Chart');

Example 4: Multi-layer nested pie chart

% Initialize data points
inner_pie = [0.1, 0.15, 0.2, 0.05, 0.3, 0.2];
middle_pie = [0.2, 0.05, 0.1, 0.1, 0.05, 0.1, 0.2, 0.2];
outer_pie = [0.25, 0.25, 0.5];
C = {...
    inner_pie,... % Inner to outer layer
    middle_pie,...
    outer_pie};

% Spider plot
nested_pie(C,...
    'PercentStatus', {'off', 'off', 'off'});

% Title
title('Nested Pie Chart');

Example 5: Adjust order in which pie layer is displayed in legend

% Initialize data points
inner_pie = [0.1, 0.15, 0.2, 0.05, 0.3, 0.2];
middle_pie = [0.2, 0.05, 0.1, 0.1, 0.05, 0.1, 0.2, 0.2];
outer_pie = [0.25, 0.25, 0.5];
outer_label = {...
    'Outer Pie #1',...
    'Outer Pie #2',...
    'Outer Pie #3'};

% Custom colors
inner_colors = [...
    0 0.4470 0.7410;...
    0 0.4470 0.7410;...
    0 0.4470 0.7410;...
    0 0.4470 0.7410;...
    0 0.4470 0.7410;...
    0 0.4470 0.7410;];
middle_colors = [...
    0.8500 0.3250 0.0980;...
    0.8500 0.3250 0.0980;...
    0.8500 0.3250 0.0980;...
    0.8500 0.3250 0.0980;...
    0.8500 0.3250 0.0980;...
    0.8500 0.3250 0.0980;...
    0.8500 0.3250 0.0980;...
    0.8500 0.3250 0.0980];
outer_colors = [...
    0.9290 0.6940 0.1250;...
    0.9290 0.6940 0.1250;...
    0.9290 0.6940 0.1250];
wedge_colors = {...
    inner_colors,...
    middle_colors,...
    outer_colors};

C = {...
    inner_pie,... % Inner to outer layer
    middle_pie,...
    outer_pie};

% Spider plot
h = nested_pie(C,...
    'PercentStatus', {'off', 'off', 'off'},...
    'WedgeColors', wedge_colors,...
    'LabelText', outer_label,...
    'LegendOrder', [2, 1, 3]);

% Title
title('Nested Pie Chart');

% Legend properties
legend_str = cell(length(middle_pie), 1);
for ii = 1:length(legend_str)
    legend_value = middle_pie(ii);
    legend_str{ii} = sprintf('Middle Pie #%i: %04.1f%%', ii, legend_value*100);
end
lg =legend(legend_str, 'Location', 'eastoutside');
lg.Title.String = 'Middle Pie';

Author:

Moses Yoo, (juyoung.m.yoo at gmail dot com)

Special Thanks:

Special thanks to the following people for their feature recommendations and bug finds.

  • Leila

View nested_pie on File Exchange

Cite As

Moses (2024). nested_pie (https://github.com/NewGuy012/nested_pie/releases/tag/3.5), GitHub. Retrieved .

MATLAB Release Compatibility
Created with R2022b
Compatible with any release
Platform Compatibility
Windows macOS Linux

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Version Published Release Notes
3.5.0.0

See release notes for this release on GitHub: https://github.com/NewGuy012/nested_pie/releases/tag/3.5

3.4.0.0

See release notes for this release on GitHub: https://github.com/NewGuy012/nested_pie/releases/tag/3.4

3.3.0.0

See release notes for this release on GitHub: https://github.com/NewGuy012/nested_pie/releases/tag/3.3

3.2.0.0

See release notes for this release on GitHub: https://github.com/NewGuy012/nested_pie/releases/tag/3.2

3.1.0.0

See release notes for this release on GitHub: https://github.com/NewGuy012/nested_pie/releases/tag/3.1

3.0.0.0

See release notes for this release on GitHub: https://github.com/NewGuy012/nested_pie/releases/tag/3.0

2.2.0.0

See release notes for this release on GitHub: https://github.com/NewGuy012/pie_nested/releases/tag/2.2

2.0.0.0

See release notes for this release on GitHub: https://github.com/NewGuy012/pie_nested/releases/tag/2.0

1.3.0.0

See release notes for this release on GitHub: https://github.com/NewGuy012/pie_nested/releases/tag/1.3

1.2.0.0

See release notes for this release on GitHub: https://github.com/NewGuy012/pie_nested/releases/tag/1.2

1.1.0.0

See release notes for this release on GitHub: https://github.com/NewGuy012/nested_pie/releases/tag/1.1

1.0

To view or report issues in this GitHub add-on, visit the GitHub Repository.
To view or report issues in this GitHub add-on, visit the GitHub Repository.