ecl-logo Documentation

EmeraldPieChart

EmeraldPieChart[dataset]chart

creates a PieChart of dataset.

EmeraldPieChart[datasets]chart

creates a PieChart displaying each dataset in datasets.

Details

    Input
    Output
    Data Specifications Options
    Frame Options
    Grid Options
    Image Format Options
    Legend Options
    Plot Labeling Options
    Plot Style Options
    General Options

Examples

Basic Examples  (2)

Create a pie chart of a list of heights:

Create a pie chart containing multiple data sets:

Additional Examples  (9)

Missing Data  (4)

Null values in a data set are ignored:

Data set elements are associated with one another starting from the left. Missing elements are ignored:

Null values in any data set are ignored:

Entire missing data sets also ignored:

Quantity Arrays  (3)

Chart a single data set given as a QuantityArray:

A list of quantity array data sets:

Given a QuantityArray containing a single group of data sets:

Units  (2)

Chart data with units:

Data units can be different, but must be compatible:

Options  (65)

AspectRatio  (1)

Adjust the aspect ratio of the graphic. Default is 1.0:

Background  (1)

Set the background color of the plot:

Boxes  (2)

Use swatch boxes in legend:

Use line segments in legend instead of swatch boxes:

ChartBaseStyle  (3)

Use ChartBaseStyle to sector styling:

ChartStyle overrides settings for ChartBaseStyle:

ColorFunction may override settings for ChartBaseStyle:

ChartElementFunction  (3)

Use a named, preset chart element function (To see all options, please run ChartElementData["PieChart"] in the notebook):

Write a custom chart element function for PieChart:

Built-in element functions may have options; use Palettes ChartElementSchemes to set them:

ChartLabels  (2)

Add labels to each sector in the pie chart:

When multiple datasets are provided, ChartLabels 'rows' correspond to datasets, and 'columns' correspond to single entries:

ChartLayout  (1)

ChartLayout determines how multiple datasets are plotted, and can be set to either "Grouped" (default) or "Stacked":

ChartLegends  (3)

Label the bars (columns):

Label the datasets (rows):

Label the rows and columns of the data:

ChartStyle  (7)

Pass a single argument to ChartStyle to style all sectors the same way:

Style the chart using a named color scheme from ColorData[]:

Pass a list of colors to ChartStyle to apply different styles to each sector in each group:

Pass a list of style directives to ChartStyle to apply different styles to each sector in each group:

Style each group the same way:

Style each group and each series of sector in each input dataset, in the format { {in1, in2,..}, {sec1,sec2,sec3,..}}:

Use indexed colors for charting. Run ColorData["Charting"] to see possible index values:

ColorFunction  (3)

Apply a named color function to color sectors by angle:

Supply a pure function to style each sector with an opacity equal to its angle:

ColorFunction overrides ChartStyle:

ColorFunctionScaling  (1)

By default, the color function takes scaled sector angles (i.e. angle/2*pi). Set ColorFunctionScaling->False to receive absolute sector angles:

DisplayFunction  (1)

Provide the output as a clickable button:

Epilog  (1)

Epilogs explicitly specified are joined onto any epilogs created by EmeraldPieChart:

Frame  (2)

Set Frame->True to use a frame on all four sides of the plot:

By default, Frame->None in a PieChart:

FrameLabel  (1)

The FrameLabel option is disabled for pie charts:

FrameStyle  (2)

Apply styling to the frame of the plot:

Apply different stylings to each frame wall, referenced using {{left,right},{bottom,top}}:

FrameTicks  (1)

If Frame->True, set FrameTicks->None to disable ticks in the plot. Note that in a PieChart the FrameTicks run from zero to one, and are disabled by default:

FrameTicksStyle  (2)

Apply styling to all FrameTicks in the plot:

Apply a different styling to each frame wall, using {{left,right},{bottom,top}} syntax:

GridLines  (3)

Use either None or Automatic to specify {vertical,horizontal} gridlines:

Explicitly specify gridlines. By default, the PieChart runs from {-1,1} in both directions:

Specify each gridline as a {value,Directive} pair to apply specific styling to individual grid lines:

GridLinesStyle  (1)

Apply the same style to all grid lines in the plot:

ImageSize  (3)

Adjust the size of the output image:

Specify the size as a {width,height} pair:

Specify the size using keywords Small, Medium, or Large:

LabelingFunction  (5)

By default, each sector in the pie chart is labeled with a tooltip which shows its magnitude:

Set LabelingFunction->None to disable tooltips:

Change the LabelingFunction to a named default to get different labels:

Change the LabelingFunction to a named default to get different labels for multi-dataset plots:

Use a pure function to programatically generate labels for the elements. The function input is the individual sector magnitude:

LabelStyle  (1)

Adjust the font size, font color, formatting, and font type of all label-like elements in the chart:

Legend  (2)

Specify a legend:

Specify a legend:

LegendAppearance  (1)

Specify they layout of the chart legend:

LegendPlacement  (1)

Specify legend position:

PlotLabel  (1)

Supply a title with PlotLabel:

PlotRange  (1)

The plot range for a pie chart runs from -1 to 1 in both directions, and cannot be changed:

PlotTheme  (1)

PlotTheme is disabled in Emerald plot functions:

PolarAxes  (1)

Explicitly set PolarAxes->Automatic to quantitatively show sector angle magnitudes:

Prolog  (1)

Prologs are drawn before chart elements, such that they appear behind the pie chart:

SectorOrigin  (2)

Specify where sectors should be drawn from and which direction they should be drawn. Default is {π,-1}:

Use different starting positions for the pie chart:

SectorSpacing  (3)

Define the spacing between datasets when multiple datasets are plotted in the same pie chart:

Define the spacing between sectors for a pie chart showing a single dataset. Default is None:

Use explicit numbers to define spacings between {sectors,datasets}:

TargetUnits  (1)

Set the units that the chart tooltips should be converted to. Compatible units must be provided:

Messages  (2)

IncompatibleUnits  (2)

Incompatible units within a data set:

Incompatible units across data sets:

Possible Issues  (1)

Null values  (1)

Null, zero, and negative values are all treated the same way and do not get pie slices: