ecl-logo Documentation

EmeraldBarChart

EmeraldBarChart[dataset]chart

creates a bar chart from the provided dataset.

EmeraldBarChart[datasets]chart

creates a bar chart displaying each dataset in datasets.

Details

  • Data points specified as Replicates are turned into a bar whose height is the mean of the replicates list, and an error bar whose size is the standard deviation of the replicates list.
  • Data points specified as distributions are turned into a bar whose height is the mean of the distribution, and an error bar whose size is the standard deviation of the distriubtion.
  • Data points specified as PlusMinus[m,s] are turned into a bar whose height is m, and an error bar whose size is s.
  • Input
    Output
    Data Specifications Options
    Frame Options
    Grid Options
    Image Format Options
    Legend Options
    Plot Labeling Options
    Plot Range Options
    Plot Style Options
    General Options

Examples

Basic Examples  (2)

Create a bar chart from a list of heights:

Create a bar chart containing multiple data sets:

Additional Examples  (13)

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:

A single QuantityArray containing grouped datasets:

Replicates  (3)

Use replicate data. The mean is used for bar height and standard deviation is used to construct an error bar:

Use PlusMinus and distributions as data points:

Mix parametric distributions, empirical distributions, Replicates, and multiple data sets:

Units  (3)

Chart data with units:

Data units can be different, but must be compatible:

Can also put units on replicate and PlusMinus data points:

Options  (82)

AlignmentPoint  (2)

When this graphic is used within an Inset, AlignmentPoint determines the coordinates in this graphic to which it will be aligned in the enclosing graphic:

The AlignmentPoint can be specified with explicit x-y coordinates:

AspectRatio  (1)

Adjust the aspect ratio of the graphic. Default is 1/GoldenRatio:

Axes  (1)

Axes are unused in bar charts:

AxesLabel  (1)

Axes are unused in EmeraldBarChart, so the AxesLabel option should have no effect:

AxesStyle  (1)

Axes are unused in EmeraldBarChart, so the AxesLabel option should have no effect:

Background  (1)

Set the background color of the plot:

BarOrigin  (1)

Specify from which side bars should be drawn:

BarSpacing  (4)

Specify the spacing between bars:

Specify the spacing between bars using explicit widths, where 1.0 corresponds to the width of a single bar:

Specify the spacing between bars and the spacing between groups, with the syntax {bars, groups}:

Set a negative BarSpacing to force bars to overlap:

Boxes  (2)

Use swatch boxes in legend:

Use line segments in legend instead of swatch boxes:

ChartBaseStyle  (1)

Apply a style directive to all bars in the bar chart:

ChartLabels  (3)

Label the bars (columns):

Label the datasets (rows):

Label the rows and columns of the data:

ChartLayout  (4)

By default, EmeraldBarChart uses ChartLayout->Grouped:

Use ChartLayout->Stepped to emphasize a change over time in the bar chart:

Use ChartLayout->Stacked to emphasize both the distribution and size of each data group:

Use ChartLayout->Percentile to emphasize the percentage of each group each bar constitutes:

ChartStyle  (5)

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

Style the chart named color scheme from ColorData[]:

Pass a list of arguments to ChartStyle to apply different styles to each bar in each group:

Style each group the same way:

Style each group and each series of bars in each group, in the format { {group1, group2,..}, {bar1,bar2,bar3,...}}:

ColorFunction  (2)

Use a color function to color bars as a function of each bar height:

The color function can specify both color and other graphics options, such as opacity:

ColorFunctionScaling  (1)

By default, the color function uses scaled heights. Absolute heights can be used by setting ColorFunctionScaling->False:

ColorOutput  (1)

ColorOutput has been deprecated and does not affect the plot:

ContentSelectable  (1)

Set ContentSelectable->True to make the bars selectable by click:

CoordinatesToolOptions  (1)

Pass options to the CoordinatesTool to determine how coordinates should be display. Select the plot and press "." to use the coordinate picker tool:

Epilog  (1)

Explicitly specified epilogs are joined onto any epilogs created by EmeraldBarChart:

ErrorBars  (2)

Show error bars over averaged replicated data:

Do not show error bars over averaged replicated data:

ErrorType  (2)

Specify that error bars correspond to StandardDeviation:

Specify that error bars correspond to StandardError, when possible. Note that StandardError is not meaningful for parametric distriubtions, so only data-based distributions will show StandardError:

Frame  (3)

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

Set Frame->None to hide the frame:

Set Frame with format {{left,right},{bottom,top}} to selectively enable or disable frame walls:

FrameLabel  (2)

Specify frame labels for unitless data:

Override a default label:

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)

Set FrameTicks->None to disable ticks in the plot:

FrameTicksStyle  (2)

Apply styling to all FrameTicks in the plot:

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

FrameUnits  (4)

By default, the data's units are automatically appended to the frame label:

If the data is unitless, no units will be appended:

Use FrameUnits->None to stop automatic appeneding of units. For example, if you want to specify the units inside the frame label manually:

Can also explicitly specify a FrameUnit to override the data's units:

GridLines  (3)

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

Explicitly specify gridlines, e.g. to increase the grid resolution around particular values:

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:

ImageSizeRaw  (1)

ImageSizeRaw is an option used for web-embedding, and otherwise has no effect on plot output:

IntervalMarkers  (1)

The IntervalMarkers used by EmeraldBarChart default to "Fences", and currently cannot be changed:

IntervalMarkersStyle  (1)

IntervalMarkersStyle is not currently supported by EmeraldBarChart, and has no effect on the output plot:

Joined  (1)

Join the tops of the bars with a contiguous line:

LabelingFunction  (1)

Use a labeling function to automatically generate a label for each bar in 15pt bolded red text:

LabelStyle  (1)

Adjust the font size, font color, formatting, and font type of labels:

Legend  (1)

Specify a legend:

LegendPlacement  (1)

Specify legend position:

PerformanceGoal  (1)

PerformanceGoal may be set to either "Quality" or "Speed". Note that for 2D Graphics, performance is typically comparable between these two options:

PlotLabel  (1)

Supply a plot title with PlotLabel:

PlotRange  (2)

Specify plot range for primary data. Units in PlotRange must be compatible with primary data units:

Can mix explicit specification with Automatic resolution:

PlotRangeClipping  (1)

Set PlotRangeClipping->False to allow the bars to display outside of the PlotRange:

PreserveImageOptions  (1)

Specify whether image size and certain other options should be preserved from the previous version of a graphic if the graphic is replaced by a new one in output, e.g. by Dynamics:

Prolog  (1)

Use Prolog to render other graphics primitives prior to BarChart graphics, such that these graphics appear behind the bars:

RotateLabel  (1)

Specify if the y-axis frame label should be rotated:

Scale  (2)

Create a Log BarChart:

Error bars also get scaled in log chart:

TargetUnits  (2)

Specify target y-unit for data. If Automatic, the value is taken as the data's unit. TargetUnits must be compatible with the data's units:

Incompatible target unit triggers a message and returns $Failed:

Ticks  (1)

Ticks is unused in EmeraldBarChart - please use FrameTicks instead:

TicksStyle  (1)

Ticks is unused in EmeraldBarChart - please use FrameTicksStyle instead:

Zoomable  (1)

Make the plot zoomable:

Messages  (4)

ExplicitNullOptions  (1)

Options cannot be specified with Null. Null values will be ignored and replace with default option values:

IncompatibleUnits  (2)

Incompatible units within a data set:

Incompatible units across data sets:

UnresolvedPlotOptions  (1)

This message is used exclusively for development and testing, and should not be returned:

Possible Issues  (1)

Null values  (1)

Zero values get a bar with no height, while Null values get no bar: