Skip to contents

IOM ggplot2 theme

Source: R/theme_iom.R
theme_iom.Rd

theme_iom provides a basic IOM theme to use in ggplot2 commands.

Usage

theme_iom(
  font_family = if (package_font_installed()) "Open Sans" else "Arial",
  font_size = 12,
  plot_title_size = rel(1.35),
  plot_title_margin = font_size,
  subtitle_size = font_size,
  subtitle_margin = font_size * 1.5,
  strip_text_size = rel(0.9),
  strip_text_face = "bold",
  strip_text_just = 0,
  caption_size = rel(0.7),
  caption_margin = font_size,
  axis_text = TRUE,
  axis_text_size = rel(0.9),
  axis_title = TRUE,
  axis_title_size = rel(0.9),
  axis = FALSE,
  axis_ticks = FALSE,
  grid = "XY",
  legend = TRUE,
  legend_text_size = rel(0.9),
  legend_title = FALSE,
  legend_title_size = rel(0.9),
  plot_margin = margin(font_size, font_size, font_size, font_size),
  plot_background = "#ffffff",
  void = FALSE
)

Arguments

font_family

Base font family "Open Sans". You need to have "Open Sans" font installed on your device in order to use it.

font_size

Base font size in pt. Default to 12 pts.

plot_title_size

Plot title font size. Default to font_size * 1.35.

plot_title_margin

Plot title bottom margin. Default to font_size.

subtitle_size

Plot subtitle font size. Default to font_size.

subtitle_margin

Plot subtitle bottom margin. Default to font_size * 1.5.

strip_text_size

Facet label font size. Default to font_size * 0.9.

strip_text_face

Facet label font face. Default to "bold".

strip_text_just

Facet label justification. Default to 0.

caption_size

Caption font size. Default to font_size * 0.7.

caption_margin

Caption top margin. Default to font_size.

axis_text

Logical TRUE/FALSE or xy. Turn on and off axis label. Use x or y to have only the correspondent active. Default to TRUE.

axis_text_size

Axis label font size. Default to font_size * 0.9.

axis_title

Logical TRUE/FALSE or xy. Turn on and off axis title. Use x or y to have only the correspondent active. Default to TRUE.

axis_title_size

Axis title font size. Default to font_size * 0.9.

axis

Logical TRUE/FALSE or xy. Turn on and off axis. Use x or y to have only the correspondent axis active. Don't forget to review the expand argument of the scale_x_*/scale_y_* to avoid spacing between the axis and the baseline of the plot. Default to FALSE.

axis_ticks

Logical TRUE/FALSE or xy. Turn on and off axis ticks. Use x or y to have only the correspondent axis ticks active. Default to FALSE.

grid

Logical TRUE/FALSE or a combination of X or x and Y or y. Turn on and off panel grids. Use XorYfor major grids, andxoryfor minor grid. Default toXY`.

legend

Logical TRUE/FALSE. Turn on and off the legend. Default to TRUE.

legend_text_size

Legend key font size. Default to font_size * 0.9.

legend_title

Logical TRUE/FALSE. Turn on and off the legend title. Default to FALSE.

legend_title_size

Legend title font size. Default to font_size * 0.9.

plot_margin

Plot margin (specify with ggplot2::margin()). Default to ggplot2::margin(font_size, font_size, font_size, font_size).

plot_background

Plot background. Put "transparent" for no background color. Default to "white".

void

Logical TRUE/FALSE. If TRUE, all grid lines, ticks and axes are removed. Default to FALSE.

Value

A ggplot2 theme object, the theme style.

Examples

## Usage

#After loading the `{iomthemes}` package, you can apply the theme to 
# any `{ggplot2}` chart, by simply adding `theme_iom` at your call. 

# For example:

# Load packages
library(ggplot2)
library(iomthemes)

# A dummy data frame
df <- data.frame(
  date = factor(rep(2010:2020, 2)),
  val = c(
    10.2, 10.2, 10.2, 11.5, 14,
    15.8, 17, 19.5, 20.5, 24.5, 20.6,
    4.9, 4.9, 4.9, 5.5, 5.5, 5.6,
    5.6, 5.7, 5.7, 5.8, 5.9
  ),
  set = rep(c("Set 1", "Set 2"), each = 11)
)

# Base plot with theme_iom()
ggplot(
  data = df,
  aes(x = date, y = val, fill = set)
) +
  geom_col(
    position = position_stack(reverse = TRUE),
    width = 0.8
  ) +
  labs(
    title = "My title | 2010-2020",
    subtitle = "My subtitle",
    x = "date",
    y = "values",
    caption = "Source: Dummy data"
  ) +
  theme_iom()
#> Warning: OS is not Windows. No fonts registered with windowsFonts().
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database


# The theme comes with some default settings, but you can customize most of it
#by adding parameters to the function call, as we will explore below.

## Grid

# The `grid` parameter controls the display of both major and minor grid lines 
#in your plot. By default, major grid lines are visible and minor ones are hidden.
# 
# Using `grid = "XY"` adds both major X and Y grid lines, `grid = "X"` adds
# only major X grid lines, `grid = "Y"` adds only major Y grid lines, 
#and `grid = FALSE` removes all grid lines. 
# You can add minor grid lines by using lowercase `"xy"`, `"x"` or `"y"`. 

#For example, let’s keep only the major Y grid lines:
 
ggplot(
  data = df,
  aes(x = date, y = val, fill = set)
) +
  geom_col(
    position = position_stack(reverse = TRUE),
    width = 0.8
  ) +
  labs(
    title = "My title | 2010-2020",
    subtitle = "My subtitle",
    x = "date",
    y = "values",
    caption = "Source: Dummy data"
  ) +
  theme_iom(
    grid = "Y" # Only major Y grid lines
  )
#> Warning: OS is not Windows. No fonts registered with windowsFonts().
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database

 

# # Axis

# Unsurprisingly, the axis represents the axis lines. However, it also includes
#different axis elements such as the axis title, axis text, and axis ticks.

### Axis lines

#To control the visibility of axis lines, you can use the `axis` parameter 
# in the `theme_iom` function. By default, this parameter is set to `FALSE`,
# which turns off all the axis lines. Using `axis = "XY"` (or `axis = TRUE`)
# adds both X and Y axis, `axis = "X"` adds only the X axis, `axis = "Y"` 
#adds only the Y axis, and `axis = FALSE` removes all axis elements. 

#For example, let's add only the X axis:

 
ggplot(
  data = df,
  aes(x = date, y = val, fill = set)
) +
  geom_col(
    position = position_stack(reverse = TRUE),
    width = 0.8
  ) +
  labs(
    title = "My title | 2010-2020",
    subtitle = "My subtitle",
    x = "date",
    y = "values",
    caption = "Source: Dummy data"
  ) +
  theme_iom(
    grid = "Y",
    axis = "X" # Only X axis
  )
#> Warning: OS is not Windows. No fonts registered with windowsFonts().
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database

 
# Some space is missing! This is because `{ggplot2}` comes, by default, 
# with some expansion around the axis to create some room. 
# To remove this extra space, you can use the `expand` argument 
# in the `scale_x_*` or `scale_y_*` function.
# 
# **Modify the axis expansion:**
# 
# In this example, we will set the `expand` argument to `expansion(c(0, 0.01))` 
# for the y axis to remove the unwanted space, effectively “expanding” the axis
# by removing the space at the axis origin and adding a small padding 
# at the other end.

ggplot(
  data = df,
  aes(x = date, y = val, fill = set)
) +
  geom_col(
    position = position_stack(reverse = TRUE),
    width = 0.8
  ) +
  labs(
    title = "My title | 2010-2020",
    subtitle = "My subtitle",
    x = "date",
    y = "values",
    caption = "Source: Dummy data"
  ) +
  scale_y_continuous(
    expand = expansion(c(0, 0.01)) # Remove axis expansion
  ) +
  theme_iom(
    grid = "Y",
    axis = "X"
  )
#> Warning: OS is not Windows. No fonts registered with windowsFonts().
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database

 

### Axis title and text

#To control the visibility of axis titles and text, you can use the `axis_title`
# and `axis_text` parameters in the `theme_iom` function. By default, 
#these parameters are set to `TRUE`, which turns on all the axis titles and 
# text. Using `axis_title = FALSE` removes both X and Y axis titles,
# `axis_title = "X"` adds only the X axis title, `axis_title = "Y"` adds 
# only the Y axis title, and `axis_title = TRUE` adds all axis titles. 
# Similarly, `axis_text = TRUE` adds both X and Y axis text, `axis_text = "X"`
# adds only the X axis text, `axis_text = "Y"` adds only the Y axis text,
#and `axis_text = FALSE` removes all axis text. 

#For example, let's keep only the Y axis title:
 
ggplot(
  data = df,
  aes(x = date, y = val, fill = set)
) +
  geom_col(
    position = position_stack(reverse = TRUE),
    width = 0.8
  ) +
  labs(
    title = "My title | 2010-2020",
    subtitle = "My subtitle",
    y = "values",
    caption = "Source: Dummy data"
  ) +
  scale_y_continuous(
    expand = expansion(c(0, 0.01))
  ) +
  theme_iom(
    grid = "Y",
    axis = "X",
    axis_title = "Y" # Only Y axis title
  )
#> Warning: OS is not Windows. No fonts registered with windowsFonts().
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database

#
### Axis ticks

#Axis ticks can sometimes be useful. To control the visibility of axis ticks,
# you can use the `axis_ticks` parameter in the `theme_iom` function.
# By default, this parameter is set to `FALSE`, which turns off all the 
# axis ticks. Using `axis_ticks = TRUE` adds both X and Y axis ticks, 
# `axis_ticks = "X"` adds only the X axis ticks, `axis_ticks = "Y"` adds only
# the Y axis ticks, and `axis_ticks = FALSE` removes all axis ticks.

## Text

# Like all the chart elements, the different text elements, such as the 
# plot title, subtitle, caption, and more, can be controlled using the
# `theme_iom` function. We encourage you, not to touch any of these parameters,
# as they are part of IOM branding and should be used as is. 
# However, you can still adjust the font size, font family, margin or 
#justification of each of these elements using, for example,
#the `plot_title_size`, `plot_title_margin`, etc. parameters.

#On top of the `theme_iom` parameters, the `{iomthemes}` package natively 
# incorporates the `{ggtext}` package for advanced text rendering in the title,
# subtitle and caption components. To showcase this, you can use the `{ggtext}` 
# functionalities to include styled text directly in your plots.
 
ggplot(
  data = df,
  aes(x = date, y = val, fill = set)
) +
  geom_col(
    position = position_stack(reverse = TRUE),
    width = 0.8
  ) +
  labs(
    # Add some HTML style to the title
    title = "My title including
             <span style='color:#0033A0;'>highlight color</span> | 2010-2020",
    # Automatic wrapping of long text
    subtitle = "My really long subtitle that will cover more than one line and
                that will be automatically wrapped thanks to ggtext so I don't
                have to manually put a line break",
    y = "values",
    # Line break in the caption, use <br> instead of \n
    caption = "Note: As it's HTML text the line break symbol is not
               '\\n'<br>Source: Dummy data"
  ) +
  scale_y_continuous(
    expand = expansion(c(0, 0.01))
  ) +
  theme_iom(
    grid = "Y",
    axis = "X",
    axis_title = "Y"
  )
#> Warning: OS is not Windows. No fonts registered with windowsFonts().
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database


### Add text labels

#Text labels added with `geom_text` will also display using the recommended 
# font and style.
 
ggplot(
  data = df,
  aes(x = date, y = val, fill = set)
) +
  geom_col(
    position = position_stack(reverse = TRUE),
    width = 0.8
  ) +
  # Add geom_text
  geom_text(aes(label = scales::number_format(accuracy = 0.1)(val)),
    position = position_stack(vjust = 0.5, reverse = TRUE),
    show.legend = FALSE
  ) +
  labs(
    title = "My title including
             <span style='color:#0033A0;'>highlight color</span> | 2010-2020",
    subtitle = "My really subtitle that will cover more than one line and that
                will be automatically wrapped thanks to ggtext so I don't have 
                to manually put a line break",
    y = "values",
    caption = "Note: As it's HTML text the line break symbol is
              not '\\n'<br>Source: Dummy data"
  ) +
  scale_y_continuous(
    expand = expansion(c(0, 0.01))
  ) +
  theme_iom(
    grid = "Y",
    axis = "X",
    axis_title = "Y"
  )
#> Warning: OS is not Windows. No fonts registered with windowsFonts().
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database



## Void

# To simplify the creation of pie/donut charts or maps, the `theme_iom` function
# comes with a `void` parameter. When set to `TRUE`, this parameter removes 
# all grid lines, ticks, and axes. For example, let's create a pie chart:

ggplot(
  data = dplyr::filter(df, date == 2020),
  aes(x = date, y = val, fill = set)
) +
  geom_col(
    position = position_stack(reverse = TRUE),
    width = 0.8
  ) +
  labs(
    title = "My title | 2020",
    subtitle = "My subtitle",
    y = "values",
    caption = "Source: Dummy data"
  ) +
  scale_fill_iom_d() +
  coord_polar(
    theta = "y",
    direction = -1
  ) +
  theme_iom(
    void = TRUE # Remove all grid lines, ticks, and axes
  )
#> Warning: OS is not Windows. No fonts registered with windowsFonts().
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database
#> Warning: font family 'Arial' not found in PostScript font database