sgplot: Graphic Styles and Colours for Scottish Government Plots

Description

A 'ggplot2' theme and colour palettes to create accessible data visualisations in the Scottish Government.

Author(s)

Maintainer: Alice Hannah alice.hannah@gov.scot

Other contributors:

• Scottish Government statistics.enquiries@gov.scot [copyright holder, funder]

See Also

Useful links:

• https://github.com/ScotGovAnalysis/sgplot/

• https://ScotGovAnalysis.github.io/sgplot/

• Report bugs at https://github.com/ScotGovAnalysis/sgplot/issues

Government Analysis Function colours and palettes

Description

• af_colour_values is a vector containing colour names and their corresponding hex codes.

• af_colour_palettes is a list grouping colours into palettes.

Usage

af_colour_values

af_colour_palettes

Format

An object of class character of length 9.

An object of class list of length 5.

Source

Government Analysis Function Colours Guidance

Available palettes and palette types

Description

Available palettes and palette types

Usage

available_palettes(palette_type, error_call = rlang::caller_env())

available_palette_types()

Arguments

Value

A character vector of available palettes or palette types.

Examples

available_palette_types()
available_palettes("sg")

Check palettes and palette types

Description

Checks values against those available in available_palette_types() and available_palettes().

Usage

check_palette(palette_type, palette, error_call = rlang::caller_env())

check_palette_type(palette_type, error_call = rlang::caller_env())

Arguments

Value

The value being checked is returned invisibly if the check is successful. Otherwise the function will return an error.

Examples

check_palette_type("sg")
check_palette("sg", "main")

Convert millimetres to inches

Description

Convert millimetres to inches

Usage

mm_to_inch(x)

Arguments

Value

A numerical value in inches

Examples

mm_to_inch(100)

Continuous colour/fill scales for Scottish Government plots

Description

Continuous colour/fill scales for Scottish Government plots

Usage

scale_colour_continuous_sg(
  palette = "sequential",
  palette_type = "sg",
  reverse = FALSE,
  na_colour = "grey50",
  guide = "colourbar",
  ...
)

scale_fill_continuous_sg(
  palette = "sequential",
  palette_type = "sg",
  reverse = FALSE,
  na_colour = "grey50",
  guide = "colourbar",
  ...
)

Arguments

Value

ggplot2 continuous colour/fill scale

Examples

library(ggplot2)

ggplot(mtcars, aes(x = mpg, y = wt, colour = cyl)) +
  geom_point() +
  scale_colour_continuous_sg()

ggplot(faithfuld, aes(x = waiting, y = eruptions, fill = density)) +
  geom_raster() +
  scale_fill_continuous_sg()

Discrete colour/fill scales for Scottish Government plots

Description

Discrete colour/fill scales for Scottish Government plots

Usage

scale_colour_discrete_sg(
  palette = "main",
  palette_type = "sg",
  reverse = FALSE,
  ...
)

scale_fill_discrete_sg(
  palette = "main",
  palette_type = "sg",
  reverse = FALSE,
  ...
)

Arguments

Value

ggplot2 discrete colour/fill scale

Examples

library(ggplot2)
library(dplyr)

economics_long %>%
  filter(variable %in% c("psavert", "uempmed")) %>%
  ggplot(aes(x = date, y = value, colour = variable)) +
  geom_line(linewidth = 1) +
  scale_colour_discrete_sg()

d <- subset(mpg, manufacturer == "ford")

ggplot(d, aes(x = class, fill = class)) +
 geom_bar() +
 scale_fill_discrete_sg()

Scottish Government colours and palettes

Description

• sg_colour_values is a vector containing colour names and their corresponding hex codes.

• sg_colour_palettes is a list grouping colours into palettes.

Usage

sg_colour_values

sg_colour_palettes

Format

An object of class character of length 11.

An object of class list of length 4.

Source

Scottish Government Design System

Social Security Scotland colours and palettes

Description

• sss_colour_values is a vector containing colour names and their corresponding hex codes.

• sss_colour_palettes is a list grouping colours into palettes.

Usage

sss_colour_values

sss_colour_palettes

Format

An object of class character of length 12.

An object of class list of length 4.

Source

Contact the Social Security Scotland Statistics mailbox with any queries about these colours and palettes.

Scottish Government theme for ggplot2 charts.

Description

ggplot2 theme for Scottish Government plots.

Usage

theme_sg(
  base_size = 12,
  base_line_size = base_size/24,
  base_rect_size = base_size/24,
  grid = c("y", "x", "xy", "none"),
  axis = c("x", "y", "xy", "none"),
  ticks = c("xy", "x", "y", "none"),
  legend = c("right", "left", "top", "bottom", "none")
)

Arguments

Value

ggplot2 theme

Examples

library(ggplot2)

p <- ggplot(mpg, aes(x = class)) + geom_bar()

p
p + theme_sg()

Use sgplot defaults.

Description

Set sgplot theme, colour palette and geom aesthetic defaults for ggplot2 charts.

Usage

use_sgplot(palette_type = "sg", ..., default_colour = deprecated())

Arguments

Value

NULL. Function is used for side effects of setting default ggplot2 theme, colour palette and geom aesthetics.

Examples

library(ggplot2)

d <- subset(mpg, manufacturer == "ford")

# ggplot2 defaults
ggplot(d, aes(x = model)) + geom_bar()
ggplot(d, aes(x = model, fill = class)) + geom_bar()

# Use sgplot defaults
use_sgplot()
ggplot(d, aes(x = model)) + geom_bar()
ggplot(d, aes(x = model, fill = class, colour = class)) + geom_bar()

# Use sgplot defaults and Social Security Scotland colour palettes
use_sgplot(palette_type = "sss")
ggplot(d, aes(x = model)) + geom_bar()
ggplot(d, aes(x = model, fill = class, colour = class)) + geom_bar()