A bar plot for a single set of bars. Multi-bar plots are achieved by having multiple BarPlots. Each bar plot corresponds to a single legend entry. To get multiple bar entries/colours, use multiple BarPlots

A add BarPlot to an Axis.

Example

import Plots
barAxis :: Axis B V2 Double
barAxis = r2Axis &~ do
  yMin ?= 0
  hide majorGridLines
  barPlot [13.5, 3.0, 6.9, 7.2, 4.6] $ do
    vertical .= True
    barWidth //= 2

barExample = renderAxis barAxis

Simple version of barPlot without any modification to the Plot.

Example

import Plots
barAxis' :: Axis B V2 Double
barAxis' = r2Axis &~ do
  xMin ?= 0
  hide (yAxis . majorGridLines)
  barPlot' [13.5, 3.0, 6.9, 7.2, 4.6]

barExample' = renderAxis barAxis'

A add BarPlot to an Axis while naming the bars.

Example

import Plots
namedBarAxis :: Axis B V2 Double
namedBarAxis = r2Axis &~ do
  yMin ?= 0
  hide (xAxis . majorGridLines)
  namedBarPlot [("eggs", 12), ("bacon", 5), ("sausage", 9), ("beans", 3)] $ do
    vertical .= True
    barWidth //= 2

namedBarExample = renderAxis namedBarAxis

Simple version of namedBarPlot without any modification to the Plot.

Example

import Plots
namedBarAxis' :: Axis B V2 Double
namedBarAxis' = r2Axis &~ do
  xMin ?= 0
  hide majorGridLines
  namedBarPlot' [("eggs", 12), ("bacon", 5), ("sausage", 9), ("beans", 3)]

namedBarExample' = renderAxis namedBarAxis'

Same as barPlot but with lower and upper bounds for the bars.

The way an individual bar plot or a group of bars plots are laid out on the axis.

Class of things that have a modifiable BarLayout.

Construct multiple bars, grouped together. See MultiBarState for details on how to customise how the bars are drawn.

Example

import Plots
breakfastData :: [(String, V2 Double)]
breakfastData = [("eggs", V2 7 5), ("bacon", V2 5 4), ("sausage", V2 2 7), ("beans", V2 2 1)]

sortedData = [ ("girls", breakfastData^..each._2._x)
             , ("boys",  breakfastData^..each._2._y)
             ]

multiBarAxis :: Axis B V2 Double
multiBarAxis = r2Axis &~ do
  yMin ?= 0
  hide (xAxis . majorGridLines)
  hide minorTicks
  xLabel .= "breakfast item"
  multiBars sortedData snd $ do
    vertical .= True
    barWidth //= 2
    labelBars (map fst breakfastData)
    onBars $ \(nm,_) -> key nm

  -- show y values without decimal point
  yAxis . tickLabelFunction .= atMajorTicks (show . round)
  -- we should really force all major ticks to like on integers too

multiBarExample = renderAxis multiBarAxis

The MultiBarState is used to set the various options available when building multiple bar plots together. The main functions used to modify this state:

• To choose the way the bars are grouped together choose one of

  • groupedBars - Together in grouped (the default)
  • stackedBars - On on top of another
  • stackedEqualBars - stackedBars with the same height
  • runningBars - each group of bars follows the last
• Modify the PlotOptions and PlotStyle of groups of bars with onBars.

• Modify the layout of the (groups of) bars with

  • orientation - Horizontal or vertical bars
  • barWidth - Width of each (group of) bar(s)
  • barSpacing - Space between each (group of) bar(s)
  • barStart - Start of centre of first bar
• Add labels to each (group of) bars with labelBars.

Bars that are grouped together such that each group is a single barWidth. The bars in a group are touching, see groupedBars' to reduce the width of individual bars.

Example

Bars that are grouped together such that each group is a single barWidth. The parameter is the multiplier for the width of individual bars, where groupedBars 1 = groupedBars corresponds to bars in a group touching. reduce the width of individual bars.

Example

Bars stacked on top of each other.

Example

Bars stacked on top of each other where every bar is the given height.

Example

Normal bars where each data set follows the last.

Example

Given the data for the bar, modify the properties for the bar that uses that data.

Some common functions to use on the PlotMods:

• plotColour - change the colour of the bars
• areaStyle - modify the style of the bars
• key - add a legend entry for that group of bars

Labels to use for each bar (or group of bars) along the axis.

Create equidistant bars using the values.

Create equidistant bars with lower and upper bounds for each bar.

Create uniform bars from groups of data, placing one group after the other.

Create uniform bars from groups of data, placing one on top of the other. The first list will be the same as mkUniformBars opts (map (0,) ys), subsequent lists will be placed on top.

Similar to mkMultiStacked but stack has the same height.

Make bars that are grouped together. Each group of bars is treated as a single bar when using the BarPlotsOpts. There is an addition parameter to adjust the width of each individual bar.