Chart.Bar

Bar charts

Documentation

data BarOptions

Typical bar chart options.

The internal model for a bar chart (across the x-axis for a vertical bar chart) is:

• half the outerGap at the start and the end.
• each row collection of bars, including the outerGap and innerGaps has a value of 1.
• the entire x range of the chart isequal to the number of rows in the bar data.
• The value of inner and outer gaps are relative to this model.

>>> let barDataExample = BarData [[1, 2, 3, 5, 8, 0, -2, 11, 2, 1], [1 .. 10]] (("row " <>) . pack . show <$> [1 .. 11]) (("column " <>) . pack . show <$> [1 .. 2])
>>> let barExample = barChart defaultBarOptions barDataExample

writeChartOptions "other/bar.svg" barExample

Constructors

BarOptions

Fields

• barRectStyles :: [RectStyle]
• barTextStyles :: [TextStyle]
• outerGap :: Double

  gap between each bar collection row.

• innerGap :: Double

  gap between bars within a row collection, negative overlaps

• textGap :: Double

  gap between top of a bar and text representation of the bar value as a proportion of the highest absolute bar value

• textGapNegative :: Double

  gap between top of a bar and text representation of the bar value, if the value is negative as a proportion of the highest absolute bar value

• displayValues :: Bool
• valueFormatN :: FormatN
• barOrientation :: Orientation
• barStacked :: Stacked
• barLegendOptions :: LegendOptions

Instances

Generic BarOptions

Defined in Chart.Bar

Associated Types

type Rep BarOptions :: Type -> Type

Methods

from :: BarOptions -> Rep BarOptions x

to :: Rep BarOptions x -> BarOptions

Show BarOptions

Defined in Chart.Bar

Methods

showsPrec :: Int -> BarOptions -> ShowS

show :: BarOptions -> String

showList :: [BarOptions] -> ShowS

Eq BarOptions

Defined in Chart.Bar

Methods

(==) :: BarOptions -> BarOptions -> Bool

(/=) :: BarOptions -> BarOptions -> Bool

type Rep BarOptions

Defined in Chart.Bar

type Rep BarOptions = D1 ('MetaData "BarOptions" "Chart.Bar" "chart-svg-0.4.0-IvsDYjPAAoJCAgDXwgibUh" 'False) (C1 ('MetaCons "BarOptions" 'PrefixI 'True) (((S1 ('MetaSel ('Just "barRectStyles") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [RectStyle]) :*: S1 ('MetaSel ('Just "barTextStyles") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [TextStyle])) :*: (S1 ('MetaSel ('Just "outerGap") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Double) :*: (S1 ('MetaSel ('Just "innerGap") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Double) :*: S1 ('MetaSel ('Just "textGap") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Double)))) :*: ((S1 ('MetaSel ('Just "textGapNegative") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Double) :*: (S1 ('MetaSel ('Just "displayValues") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Bool) :*: S1 ('MetaSel ('Just "valueFormatN") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 FormatN))) :*: (S1 ('MetaSel ('Just "barOrientation") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Orientation) :*: (S1 ('MetaSel ('Just "barStacked") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Stacked) :*: S1 ('MetaSel ('Just "barLegendOptions") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 LegendOptions))))))

defaultBarOptions :: BarOptions

The official bar options.

data BarData

Two dimensional data, maybe with row and column labels.

Constructors

BarData

Fields

• barData :: [[Double]]
• barRowLabels :: [Text]
• barColumnLabels :: [Text]

Instances

Generic BarData

Defined in Chart.Bar

Associated Types

type Rep BarData :: Type -> Type

Methods

from :: BarData -> Rep BarData x

to :: Rep BarData x -> BarData

Show BarData

Defined in Chart.Bar

Methods

showsPrec :: Int -> BarData -> ShowS

show :: BarData -> String

showList :: [BarData] -> ShowS

Eq BarData

Defined in Chart.Bar

Methods

(==) :: BarData -> BarData -> Bool

(/=) :: BarData -> BarData -> Bool

type Rep BarData

Defined in Chart.Bar

type Rep BarData = D1 ('MetaData "BarData" "Chart.Bar" "chart-svg-0.4.0-IvsDYjPAAoJCAgDXwgibUh" 'False) (C1 ('MetaCons "BarData" 'PrefixI 'True) (S1 ('MetaSel ('Just "barData") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [[Double]]) :*: (S1 ('MetaSel ('Just "barRowLabels") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Text]) :*: S1 ('MetaSel ('Just "barColumnLabels") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Text]))))

barRange :: [[Double]] -> Rect Double

Calculate the Rect range of a bar data set.

>>> barRange [[1,2],[2,3]]
Rect 0.0 2.0 0.0 3.0

>>> barRange [[]]
Rect -0.5 0.5 -0.5 0.5

bars :: BarOptions -> BarData -> [Chart]

A bar chart without hud trimmings.

>>> bars defaultBarOptions (BarData [[1,2],[2,3]] [] [])
[RectChart (RectStyle {borderSize = 5.0e-3, borderColor = Colour 0.02 0.29 0.48 1.00, color = Colour 0.02 0.29 0.48 0.70}) [Rect 5.0e-2 0.5 0.0 1.0,Rect 1.05 1.5 0.0 2.0],RectChart (RectStyle {borderSize = 5.0e-3, borderColor = Colour 0.66 0.07 0.55 1.00, color = Colour 0.66 0.07 0.55 0.70}) [Rect 0.5 0.95 0.0 2.0,Rect 1.5 1.95 0.0 3.0],BlankChart [Rect 0.0 2.0 0.0 3.0]]

>>> bars defaultBarOptions (BarData [[]] [] [])
[]

barChart :: BarOptions -> BarData -> ChartOptions

A bar chart.

>>> emptyBar = barChart defaultBarOptions (BarData [] [] [])
>>> foldOf (#charts % charts') emptyBar
[]

barRects :: BarOptions -> [[Double]] -> [[Rect Double]]

Make bars from the double list values.

>>> barRects defaultBarOptions [[1,2],[2,3]]
[[Rect 5.0e-2 0.5 0.0 1.0,Rect 1.05 1.5 0.0 2.0],[Rect 0.5 0.95 0.0 2.0,Rect 1.5 1.95 0.0 3.0]]

>>> barRects defaultBarOptions [[]]
[]