| Copyright | (C) 2016 Christopher Chalmers |
|---|---|
| License | BSD-style (see the file LICENSE) |
| Maintainer | Christopher Chalmers |
| Stability | experimental |
| Portability | non-portable |
| Safe Haskell | None |
| Language | Haskell2010 |
Plots.Style
Contents
Description
Synopsis
- data AxisStyle v
- class HasAxisStyle a where
- axisStyle :: Lens' a (AxisStyle (V a))
- axisColourMap :: Lens' a ColourMap
- axisStyles :: IndexedTraversal' Int a (PlotStyle (V a))
- fadedColours :: AxisStyle V2
- fadedColours3D :: AxisStyle V3
- vividColours :: AxisStyle V2
- blackAndWhite :: AxisStyle V2
- data PlotStyle v
- class HasPlotStyle f a where
- plotStyle :: LensLike' f a (PlotStyle (V a))
- plotColour :: Functor f => LensLike' f a (Colour Double)
- plotColor :: Functor f => LensLike' f a (Colour Double)
- lineStyle :: Settable f => LensLike' f a (Style (V a) Double)
- lineStyleFunction :: Functor f => LensLike' f a (Colour Double -> Style (V a) Double)
- markerStyle :: Settable f => LensLike' f a (Style (V a) Double)
- markerStyleFunction :: Functor f => LensLike' f a (Colour Double -> Style (V a) Double)
- areaStyle :: Settable f => LensLike' f a (Style (V a) Double)
- areaStyleFunction :: Functor f => LensLike' f a (Colour Double -> Style (V a) Double)
- textStyle :: Settable f => LensLike' f a (Style (V a) Double)
- textStyleFunction :: Functor f => LensLike' f a (Colour Double -> Style (V a) Double)
- plotMarker :: Functor f => LensLike' f a (Diagram (V a))
- plotStyles :: Settable f => LensLike' f a (Style (V a) Double)
- plotStyleFunctions :: Applicative f => LensLike' f a (Colour Double -> Style (V a) Double)
- applyLineStyle :: (InSpace v Double t, ApplyStyle t) => PlotStyle v -> t -> t
- applyMarkerStyle :: (InSpace v Double t, ApplyStyle t) => PlotStyle v -> t -> t
- applyAreaStyle :: (InSpace v Double t, ApplyStyle t) => PlotStyle v -> t -> t
- applyTextStyle :: (InSpace v Double t, ApplyStyle t) => PlotStyle v -> t -> t
- colours1 :: OrderedField n => [Colour n]
- colours2 :: OrderedField n => [Colour n]
- asterisk :: OrderedField n => Int -> n -> Path V2 n
- diamond :: (InSpace V2 n t, FromTrail t, OrderedField n) => n -> t
- crossShape :: (InSpace V2 n t, FromTrail t, OrderedField n) => n -> t
- star' :: (InSpace V2 n t, FromTrail t, OrderedField n) => n -> t
- plus :: (InSpace V2 n t, FromTrail t, OrderedField n) => n -> t
- lineMarkers :: OrderedField n => [Path V2 n]
- data ColourMap
- ixColour :: Double -> Lens' ColourMap (Colour Double)
- ixColourR :: Rational -> Lens' ColourMap (Colour Double)
- cmTraverse :: IndexedTraversal' Rational ColourMap (Colour Double)
- colourMap :: [(Rational, Colour Double)] -> ColourMap
- colourList :: ColourMap -> [(Rational, Colour Double)]
- toStops :: ColourMap -> [GradientStop]
- data NanColours
- class HasNanColours a where
- nanColours :: Lens' a NanColours
- nanColour :: Lens' a (Colour Double)
- infColour :: Lens' a (Colour Double)
- negInfColour :: Lens' a (Colour Double)
- viridis :: ColourMap
- magma :: ColourMap
- inferno :: ColourMap
- plasma :: ColourMap
- greys :: ColourMap
The axis style
The AxisStyle determines the Styles of the plots in an axis.
There are various predefined styles to change the look of the plot.
Instances
class HasAxisStyle a where Source #
Class of things that have an AxisStyle.
Minimal complete definition
Methods
axisStyle :: Lens' a (AxisStyle (V a)) Source #
Lens onto the AxisStyle.
axisColourMap :: Lens' a ColourMap Source #
axisStyles :: IndexedTraversal' Int a (PlotStyle (V a)) Source #
Instances
| HasAxisStyle (AxisStyle v) Source # | |
| HasAxisStyle (Axis v) Source # | |
Predefined styles
fadedColours :: AxisStyle V2 Source #
Theme using funColours with faded fills and thick lines.
vividColours :: AxisStyle V2 Source #
Theme using funColours with no lines on 'areaStyle.
blackAndWhite :: AxisStyle V2 Source #
Theme without any colours, useful for black and white documents.
Plot Style
Plot styles are used to style each plot in an axis. Every Axis
comes with a list of plots styles (contained in the AxisStyle)
which get applied the plots upon rendering.
You can either change the list of plot styles used with
axisStyle:
stylishAxis = r2Axis &~ do axisStyle .= vividColours linePlot [(1,2) (3,4)] $ key "line 1" linePlot [(1,1) (4,2)] $ key "line 2"
change the style for individual plots when changing the plot state.
stylishAxis2 = r2Axis &~ do
linePlot [(1,2) (3,4)] $ do
key "line 1"
plotColour .= green
linePlot [(1,1) (4,2)] $ do
key "line 2"
plotColour .= orange
A plot style is made up of separate styles (lineStyle,
markerStyle, areaStyle and textStyle) a plotColour and a
plotMarker. When rendering a plot, the PlotStyles in an
AxisStyle are used to style each plot. The lenses can be used to
customise each style when adding the plot.
plotColour- the underlying colour of the plotlineStyle- style used for lines (linePlot,connectingLinein ascatterPlot)areaStyle- style used for any area (barPlot,piePlot,histogramPlot)markerStyle- style used for markers inscatterPlotplotMarker- marker used inscatterPlot
Instances
class HasPlotStyle f a where Source #
Class for objects that contain a PlotStyle.
Minimal complete definition
Methods
plotStyle :: LensLike' f a (PlotStyle (V a)) Source #
Lens onto the PlotStyle.
plotColour :: Functor f => LensLike' f a (Colour Double) Source #
The plotColour is the overall colour of the plot. This is passed
to the other styles (lineStyle, markerStyle etc.) to give an
overall colour for the plot.
plotColor :: Functor f => LensLike' f a (Colour Double) Source #
Alias for plotColour.
lineStyle :: Settable f => LensLike' f a (Style (V a) Double) Source #
This style is applied to any plots made up of lines only (like
Path plots). This is a less general version of
lineStyleFunction.
lineStyleFunction :: Functor f => LensLike' f a (Colour Double -> Style (V a) Double) Source #
A version lineStyle with access to the current plotColour
when applyLineStyle is used.
markerStyle :: Settable f => LensLike' f a (Style (V a) Double) Source #
This style is applied to any markers in the plot (usually the
plotMarker). This is a less general version of
markerStyleFunction.
markerStyleFunction :: Functor f => LensLike' f a (Colour Double -> Style (V a) Double) Source #
A version lineStyle with access to the current plotColour when
applyMarkerStyle is used.
areaStyle :: Settable f => LensLike' f a (Style (V a) Double) Source #
This style is applied to any filled areas in a plot (like
Bar or Ribbon). This is a less
general version of areaStyleFunction.
areaStyleFunction :: Functor f => LensLike' f a (Colour Double -> Style (V a) Double) Source #
A version areaStyle with access to the current plotColour when
applyAreaStyle is used.
textStyle :: Settable f => LensLike' f a (Style (V a) Double) Source #
This style is applied to text plots. This is a less general
version of textStyleFunction.
textStyleFunction :: Functor f => LensLike' f a (Colour Double -> Style (V a) Double) Source #
A version textStyle with access to the current plotColour when
applyAreaStyle is used.
plotMarker :: Functor f => LensLike' f a (Diagram (V a)) Source #
This diagram is used as any markers in a plot (like
Scatter). The markerStyle will be applied to this
marker when the plot gets rendered.
plotStyles :: Settable f => LensLike' f a (Style (V a) Double) Source #
A traversal over all the styles (lineStyle, markerStyle,
areaStyle and textStyle) of a PlotStyle. This is a less
general version of plotStyleFunctions.
plotStyleFunctions :: Applicative f => LensLike' f a (Colour Double -> Style (V a) Double) Source #
A version of plotStyles with access to the plotColour.
Instances
Applying Plot styles
applyLineStyle :: (InSpace v Double t, ApplyStyle t) => PlotStyle v -> t -> t Source #
applyMarkerStyle :: (InSpace v Double t, ApplyStyle t) => PlotStyle v -> t -> t Source #
Apply the markerStyle from a PlotStyle.
applyMarkerStyle :: (InSpace v n t, HasStyle t) => PlotStyle v -> t -> t
applyAreaStyle :: (InSpace v Double t, ApplyStyle t) => PlotStyle v -> t -> t Source #
Apply the 'areaStyle from a PlotStyle.
applyLineStyle :: (InSpace v n t, HasStyle t) => PlotStyle v -> t -> t
applyTextStyle :: (InSpace v Double t, ApplyStyle t) => PlotStyle v -> t -> t Source #
Colour schemes
colours1 :: OrderedField n => [Colour n] Source #
A colourful colour set used for fadedColours.
colours2 :: OrderedField n => [Colour n] Source #
Another colour set, used for vividColours.
Marker shapes
asterisk :: OrderedField n => Int -> n -> Path V2 n Source #
Make an asterisk with n spokes, each of length l.
crossShape :: (InSpace V2 n t, FromTrail t, OrderedField n) => n -> t Source #
A rotated plus.
star' :: (InSpace V2 n t, FromTrail t, OrderedField n) => n -> t Source #
A filled in five sided start of size x.
lineMarkers :: OrderedField n => [Path V2 n] Source #
asterisk markers with varying numbers of prongs.
Colour maps
A map from a number (usually between 0 and 1) to a colour. Colour
maps are part of the AxisStyle, which is used for plots like
HeatMap.
Instances
| Show ColourMap Source # | |
| Ixed ColourMap Source # | |
Defined in Plots.Style | |
| At ColourMap Source # | |
| Transformable ColourMap Source # | |
| HasNanColours ColourMap Source # | |
| Each ColourMap ColourMap (Colour Double) (Colour Double) Source # | |
| type Index ColourMap Source # | |
Defined in Plots.Style | |
| type IxValue ColourMap Source # | |
Defined in Plots.Style | |
| type N ColourMap Source # | |
Defined in Plots.Style | |
| type V ColourMap Source # | |
Defined in Plots.Style | |
cmTraverse :: IndexedTraversal' Rational ColourMap (Colour Double) Source #
Indexed traversal over the colours indexed and ordered by their position in the map.
colourList :: ColourMap -> [(Rational, Colour Double)] Source #
Return the list of colours in the [0,1] range in order. This always includes colours 0 and 1.
data NanColours Source #
Colours to use when representing NaN, Infinity and -Infinity.
Instances
| Show NanColours Source # | |
Defined in Plots.Style Methods showsPrec :: Int -> NanColours -> ShowS # show :: NanColours -> String # showList :: [NanColours] -> ShowS # | |
| Default NanColours Source # | |
Defined in Plots.Style Methods def :: NanColours # | |
| HasNanColours NanColours Source # | |
Defined in Plots.Style Methods nanColours :: Lens' NanColours NanColours Source # nanColour :: Lens' NanColours (Colour Double) Source # | |
class HasNanColours a where Source #
Minimal complete definition
Methods
nanColours :: Lens' a NanColours Source #
Colours to use when displaying NaN, Infinity and -Infinity.
nanColour :: Lens' a (Colour Double) Source #
Colour to use when displaying NaN.
Default is 'white.
infColour :: Lens' a (Colour Double) Source #
Colour to use when displaying Infinity.
Default is lime.
negInfColour :: Lens' a (Colour Double) Source #
Colour to use when displaying -Infinity.
Default is magenta.
Instances
| HasNanColours ColourMap Source # | |
| HasNanColours NanColours Source # | |
Defined in Plots.Style Methods nanColours :: Lens' NanColours NanColours Source # nanColour :: Lens' NanColours (Colour Double) Source # | |
Sample maps
The viridis colour map taken from https://bids.github.io/colormap/. This is the default colour map.
The magma colour map taken from https://bids.github.io/colormap/.
The inferno colour map taken from https://bids.github.io/colormap/.
The plasma colour map taken from https://bids.github.io/colormap/.
