ggthemr v1.0.2

by Ciaran Tobin

Themes for ggplot2

Colour schemes and layouts for ggplot2.

Readme

ggthemr

Themes for ggplot2. The idea of this package is that you can just set the theme and then forget about it. You shouldn't have to change any of your existing code. There are several parts to a theme:

  • Colour palette for the background, axes, gridlines, text etc.
  • Layout of axes lines and gridlines.
  • Spacing around plot and between elements (i.e. axes titles to axes lines etc). You can set the spacing to determine how compact or spread out a plot is.
  • Text size.

There are a number of preset palettes and layouts, and methods to create your own colour schemes.

Installation

This package is still under development and isn't too stable yet, but can be installed using devtools.

devtools::install_github('cttobin/ggthemr')

Usage

To just set the colour scheme:

ggthemr('dust')

That's it. Any ggplot you create from then on will have the theme applied. You can clear the theme and return to ggplot2's default using:

ggthemr_reset()

Further Development

Features on the way:

  • More palettes and layouts.
  • Options to control fonts.
  • Ability to reset themes back to default.
  • Theme modifiers (so you can do things like plot + no_legend(), plot + no_axes() etc.).

Palettes

The palette determines the colours of everything in a plot including the background, layers, gridlines, title text, axes lines, axes text and axes titles. The swatch is the the name given to the set of colours strictly used in styling the geoms/layer elements (e.g. the points in geom_point(), bars in geom_bar() etc.). At least six colours have been supplied in each palette's swatch.

There are a wide variety of themes in this package (and more on the way). Some of them serious business... others are delibrately stylish and might not be that good for use in proper publications.

flat

Base 16

flat dark

Base 16

camoflauge

chalk

copper

dust

earth

fresh

grape

grass

greyscale

light

lilac

pale

sea

sky

solarized

Custom Palettes

define_palette() lets you make your own themes that can be passed to ggthemr() just like any of the palettes above. Here's an example of a (probably ugly) palette using random colours:

# Random colours that aren't white.
set.seed(12345)
random_colours <- sample(colors()[-c(1, 253, 361)], 10L)

ugly <- define_palette(
  swatch = random_colours,
  gradient = c(lower = random_colours[1L], upper = random_colours[2L])
)

ggthemr(ugly)

example_plot + ggtitle(':(')

You can define all elements of a palette using define_palette() including colours for the background, text, axes lines, swatch and gradients.

Layouts

The layout of a theme controls the appearance and position of the axes, gridlines and text. Some folk prefer both major and minor gridlines, others prefer none or something in between.

Clean

Clear (default)

Minimal

Plain

Scientific

Spacing

Plot margins and space between axes titles and lines etc. is controlled with the spacing parameter. Lower values will make plots more compact, higher values will give them more padding. Compare the plots below where the spacing has been set to 0, 1 and 2 respectively.

Type

The type parameter can be set to either inner or outer. When inner, the background colour of a plot will not extend past the plot area. outer will colour the entire plot and background.

ggthemr('earth', type = 'inner')
example_plot

ggthemr('earth', type = 'outer')
example_plot

Tweaking Themes

Squinting at a chart? Low on printer ink? ggthemr includes some methods to tweak charts to make them lighter or darker. Here's a standard theme:

ggthemr('dust')
example_plot

Maybe that plot comes out a bit pale looking when you print it. Here's how you can add a bit more contrast to the swatch:

darken_swatch(amount = 0.3)
example_plot

The second parameter to darken_swatch() controls the degree to which the colours are made darker. Full list of methods with similar functionality:

  • darken_swatch() / lighten_swatch(): darker/lighter swatch colours.
  • darken_gradient() / lighten_gradient(): darker/lighter gradient colours.
  • darken_palette() / lighten_palette(): darker/lighter everything.

I'll add methods to darken/lighten the axes lines and text soon too.

Plot Adjustments

Most of the time you'll probably just want to set the theme and not worry about it. There may be times though where you'll want to make some small adjustment, or manually change what items appear as what colour in a plot.

ggthemr('dust')
mpg_plot <- ggplot(mpg[mpg$drv != '4', ], aes(factor(cyl), cty, fill = drv)) + 
  geom_boxplot() + labs(x = 'Cylinders', y = 'City MPG', fill = 'Drive Type') +
  theme(legend.position = 'bottom')
mpg_plot

For some reason you decide you want to change those colours. Front-wheel drive vehicles should be orange. Rear-wheelers should be that red colour. You could change the order of the levels of your fill variable, but you shouldn't have to do that. You just want to switch those colours but you have no idea what they are. swatch() will give you the colours in the currently active ggthemr palette.

swatch()
## [1] "#555555" "#db735c" "#EFA86E" "#9A8A76" "#F3C57B" "#7A6752" "#2A91A2"
## [8] "#87F28A" "#6EDCEF"
## attr(,"class")
## [1] "ggthemr_swatch"

So you can manually swap the two colours around.

to_swap <- swatch()[2:3]
mpg_plot + scale_fill_manual(values = rev(to_swap))

Note: the first colour in a swatch is a special one. It is reserved for outlining boxplots, text etc. So that's why the second and third colours were swapped.

Functions in ggthemr

Name Description
define_palette Create ggthemr palette
align_title_left Align title left
align_title_right Align title right
darken_swatch Make ggthemr swatch darker
ggthemr_current Store Theme
darken_palette Make ggthemr palette darker
ggthemr_reset Reset Theme
get_themr Get Current Theme
colour_plot Plot colours
darken_gradient Make ggthemr gradient darker
legend_bottom ggplot2 Legend Position
is_ggthemr Is a ggthemr object
is_colour Is an object a valid colour?
lighten_palette Make ggthemr palette lighter
lighten_swatch Make ggthemr swatch lighter
lighten_gradient Make ggthemr gradient lighter
ggthemr Style ggplot2
no_axes_titles Remove ggplot2 axes titles
move_legend Move legend.
no_axes Remove ggplot2 Axes
no_major_y_gridlines Remove major y gridlines
no_major_x_gridlines Remove major x gridlines
no_legend Remove ggplot2 Legend
no_ticks Remove ggplot2 tick marks
no_gridlines Remove all gridlines
no_legend_title Remove ggplot2 Legend Title
no_major_gridlines Remove major gridlines
no_minor_y_gridlines Remove minor y gridlines
no_minor_gridlines Remove minor gridlines
no_minor_x_gridlines Remove minor x gridlines
no_y_gridlines Remove horizontal gridlines.
no_y_line Remove ggplot2 y-axis line
no_title Remove ggplot2 title
no_x_line Remove ggplot2 x-axis line
no_x_ticks Remove ggplot2 x-axis tick marks
no_y_axis Remove ggplot2 y-axis
no_x_axis Remove ggplot2 x-axis
no_x_text Remove ggplot2 x-axis text/labels
no_x_title Remove ggplot2 x-axis titles
no_x_gridlines Remove vertical gridlines.
plot.ggthemr_swatch Create colour plot of ggthemr swatch
plot.ggthemr Create colour plot of ggthemr palette
rotate_y_text Rotate ggplot2 x-axis labels
no_y_text Remove ggplot2 y-axis text/labels
no_y_ticks Remove ggplot2 y-axis tick marks
set_swatch Change the swatch colours in a ggthemr theme
random_swatch_colour Random swatch colour
reverse_gradient Reverse ggthemr gradient colours
rotate_x_text Rotate ggplot2 x-axis labels
rotate_axes_text Rotate ggplot2 axes labels
set_themr Set Current Theme
shuffle_swatch Shuffle ggthemr swatch colours
no_y_title Remove ggplot2 y-axis titles
swatch Retrieve the swatch colours from a ggthemr object
plot.ggthemr_palette Create colour plot of ggthemr palette
No Results!

Details

License GPL-3
LazyData true
RoxygenNote 5.0.1
depends ggplot2 , R (>= 3.0.0)
imports scales
Contributors Ciaran Tobin

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/ggthemr)](http://www.rdocumentation.org/packages/ggthemr)