Statistics - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Graphics : Statistics : Statistics/BarChart

Statistics

  

BarChart

  

create bar charts from data

  

ColumnGraph

  

create column graphs from data

 

Calling Sequence

Parameters

Description

Options

Notes

Examples

Compatibility

Calling Sequence

BarChart(X, options, plotoptions)

BarChart['interactive'](X)

ColumnGraph(X, options, plotoptions)

ColumnGraph['interactive'](X)

Parameters

X

-

data

options

-

(optional) equation(s) of the form option=value where option is one of datasetlabels, color, colorscheme, offset, distance, width, format or scale; specify options for generating the bar chart

plotoptions

-

options to be passed to the plots[display] command

Description

• 

The BarChart command generates a bar chart for the specified data. Several formats are available for multiple data sets: default, stacked and percent stacked. See format option below for more information. The ColumnGraph command is similar to BarChart except that numerical values are represented by vertical columns.

• 

The first parameter X is either a single data sample - given as e.g. a Vector - or a list of data samples. Note that the individual samples may be of variable size. Alternatively, X can be specified as a list of equations of type value=frequency.

• 

If the ['interactive'] option is used, then a dialog box appears that allows for customized creation of the plot.

Options

  

The options argument can contain one or more of the options shown below. All unrecognized options will be passed to the plots[display] command. See plot/options for details.

• 

datasetlabels=none, relative, absolute, or list

  

This option controls data set labels on the bars. The relative option displays, for each bar, the relative frequency of the corresponding value. The absolute option displays the absolute frequency of the corresponding value. Finally, you can specify data set labels as a list of strings or expressions.

• 

color=name, list, range, Matrix or DataFrame

  

When specified as a list or a range of colors, the option is used for coloring individual data sets. For a list of colors, each of the bars is colored with the corresponding color in the list. If a range of colors is given, a list is generated by selecting an appropriate number of equally spaced points in the corresponding hue range.

  

If both color and X are specified as Matrices, then each of the values in X gets mapped to the color located in the corresponding cell of the color Matrix and the bars are then colored accordingly. For DataFrames this mapping is done while taking the appropriate labels into account.

  

In the case where X consists of a list of data samples, each data sample gets mapped to the corresponding column of the color Matrix or DataFrame.

• 

colorscheme=[ "valuesplit", V', mapping ]

  

The first parameter in colorscheme specifies the arguments to the plotting command and for BarChart must always be set to "valuesplit" when colorscheme is defined.

  

V is an optional rtable or a list of n elements, where n is the total number of expected bars in the plot structure.

  

The ith entry in V corresponds to the ith entry in the data sample.

  

If X is specified as a list of data samples and V is given as a Matrix then each data sample corresponds to a column in V.

  

When both X and V are specified as Matrices, each of the values in X gets mapped to the value located in the corresponding cell of V. For DataFrames the appropriate labels are taken into account.

  

If V is not provided, X itself is used instead in place of V.

  

The mapping argument is commonly defined as a list of equalities specifying the mapping of values in V to colors. In the event where the mapping parameter is not supplied, a suitable color mapping for each of the distinct elements of V is automatically created with colors chosen from a default color palette. (See the plot/color help page for information about default colors for plotting.)

  

For details about the colorscheme/valuesplit option see valuesplit(colorscheme).

• 

offset=realcons

  

Initial offset along the x-axis. The default value is 0.

  

Note: By default, the view wraps tightly around all visible plot objects and the horizontal axis is marked by data set labels, not regular coordinates, so this option will have no (visual) effect. It is meant for the case where this plot is combined with other plot elements.

• 

distance=nonnegative

  

This option controls the distance between the boxes. The default value is 0.25.

• 

width=realcons

  

This option controls the cluster width. The default value is 0.75.

  

The following plot illustrates how the options offset, distance, and width are interpreted

– 

Note the lengths of the arrows labeled "offset", "width", and "distance" correspond to values for the offset, width, and distance options respectively.

• 

format=default or stacked

  

By default, individual data sets are clustered together, so that the first cluster contains the first element from each data set, the second cluster contains the second element from each data set, etc. A stacked bar chart shows related data groups, one on top of the other. A percent bar chart is similar to a stacked bar chart, except that it is rescaled to a height of 1 while preserving proportionality. If scale is set to relative and format is set to stacked then a percent stacked plot is generated.

• 

scale=absolute or relative

  

This option controls whether the absolute or relative data scale is used. If scale is set to relative and format is set to default then all data samples are rescaled so that their range belongs to an interval between -1 and 1. If scale is set to relative and format is set to stacked then a percent stacked plot is generated.

Notes

• 

Note that the labels for the data sets are placed on the axes, and should not be confused for coordinates.

• 

In the event where the options colorscheme and color are both specified, the colorscheme option takes precedence over the color option.

Examples

withStatistics:

ZSampleNormal0,1,10:

AArrayseq2+sin10Pii15+2Zi,i=1..5:

BArrayseq2+sin10Pii15+3Zi,i=1..5:

CArrayseq2+sin10Pii15+4Zi,i=1..5:

ColumnGraphA,B,C,title=Column Graph,legend=A,B,C

Plot options such as background color or gridlines are passed to the plots:-display command:

ColumnGraphA,B,C,title=Column Graph,legend=A,B,C,background=LightGrey,gridlines

TStringToolsCharacterFrequenciesantidisestablishmentarianism:

BarChartT

EseqArrayevalfseq1+sin10Pii15j,i=1..15,j=1..15:

ColumnGraphE,format=stacked,scale=relative,color=Firebrick..Orange,gridlines

The commands to create the plots from the Plotting Guide using the data above are

BarChartA,B,C

ColumnGraphE,format=stacked,color=Maroon..RoyalBlue,gridlines

The BarChart and ColumnGraph commands also accept a Matrix. The columns are understood as individual data samples.

MMatrixA,B,C,scan=columns%T

M2.128945066643401.676296491149141.290641710802311.054498902943672.725318940260571.625492954888532.257137084292531.075124304818431.503018331749612.551643960832561.830131098095101.200941784209001.958364125668772.444957590546412.82142304303481

(1)

BarChartM

ColumnGraphM,color=Orange..Red

Using Data Frames to specify the color option

dataDFDataFrame6|3|9,3|5|9,'rows'='r1','r2','columns'='c1','c2','c3':

colorDFDataFramepink|green|black,yellow|red|blue,'rows'='r2','r1','columns'='c3','c1','c2':

ColumnGraphdataDF,color=colorDF

The colorscheme option can also be used to color bars by their values

Statistics:-ColumnGraphLinearAlgebra:-RandomVector50,colorscheme=valuesplit,∞..51=Blue,50..50=DarkGreen,51..∞=DarkRed

dataMMatrixStatistics:-SampleUniform0,1,20,2|LinearAlgebra:-RandomVector20,generator=rand0..3:

Statistics:-BarChartdataM..,1,colorscheme=valuesplit,dataM..,3,0=Red,1=Blue,2=Green,3=Purple

Additional options such as style and size are passed to the plots[display] command.

XSampleUniform0,1,100:

ColumnGraphX,distance=0,style=polygon,size=640,golden

Compatibility

• 

The Statistics[BarChart] and Statistics[ColumnGraph] commands were updated in Maple 2017.

• 

The colorscheme option was introduced in Maple 2017.

• 

The color option was updated in Maple 2017.

• 

For more information on Maple 2017 changes, see Updates in Maple 2017.

See Also

Array

evalf

plots[matrixplot]

seq

Statistics

Statistics/Visualization

Statistics[AreaChart]

Statistics[LineChart]

Statistics[PointPlot]

StringTools[CharacterFrequencies]