Skip to contents

Getting Started with text2map.theme

Source: vignettes/using-themes.Rmd
using-themes.Rmd

Overview

text2map.theme provides custom ggplot2 themes and color palettes designed for academic publications and presentations. The package includes two themes (theme_t2m() and theme_solaris()) and four color palettes (viridis, inferno, grayscale, solaris).

Quick Start

The simplest way to use the package is with set_theme(), which configures the global ggplot2 theme and color palette:

# Set up the theme (uses viridis palette by default)
set_theme()

# Create a plot - theme and colors are applied automatically
ggplot(mtcars, aes(wt, mpg, color = factor(cyl))) +
 geom_point(size = 4) +
 labs(
    title = "Fuel Efficiency by Weight",
    x = "Weight (1000 lbs)",
    y = "Miles per Gallon",
    color = "Cylinders"
  )

Scatter plot with text2map theme and viridis colors

Solaris Theme

For a warmer aesthetic with a cream-colored background, use theme_solaris():

ggplot(mtcars, aes(wt, mpg, color = factor(cyl))) +
  geom_point(size = 4) +
  scale_color_solaris_d() +
  theme_solaris() +
  labs(
    title = "Fuel Efficiency by Weight",
    subtitle = "Solaris theme with cream background",
    x = "Weight (1000 lbs)",
    y = "Miles per Gallon",
    color = "Cylinders"
  )

Scatter plot with solaris theme showing cream background

Font Configuration

The package bundles Open Sans, Lato, and Source Sans 3 fonts for offline use. To enable custom fonts, set set_font = TRUE:

# Use bundled Open Sans font (default)
set_theme(set_font = TRUE)

# Use Lato instead
set_theme(set_font = TRUE, base_family = "Lato")

# Use Source Sans 3
set_theme(set_font = TRUE, base_family = "Source Sans 3")

For legacy systems, you can use the extrafont backend instead of the default showtext:

set_theme(set_font = TRUE, font_method = "extrafont")

Learn More

For more detailed documentation, see the following articles: