Skip to contents

Modified ggplot with Bootstrap branding

Source: R/theme.R
gglabs.Rd

Opinionated ggplot2 with custom element sizes and color scales derived from Bootstrap branding (per _brand.yml). Behind the scenes gglabs uses theme_brand() to control colors and fonts, and has Y-axis on the right. Axis placement can be modified with argument axes.

Usage

gglabs(
  data = NULL,
  mapping = aes(),
  axes = c("bottomright", "topright", "bottomleft", "topleft"),
  ...
)

Arguments

data

Default dataset to use for plot. If not already a data.frame, will be converted to one by fortify(). If not specified, must be supplied in each layer added to the plot.

mapping

Default list of aesthetic mappings to use for plot. If not specified, must be supplied in each layer added to the plot.

axes

2-length vector to control the position of X (bottom or top) and Y (left or right) axes (default: c("bottom", "right"))

...

Arguments passed on to theme_brand

base_bg

plot, panel, legend background

base_color

color for text and line elements

grid

show gridlines XY, X, Y (default) or n for no gridline

legend

shorthand for theme(legend.position="...") (default: top)

base_size

base font size, given in pts.

base_family

base font family

Value

A ggplot2 object with new theme elements applied

Examples

require(ggplot2)

gglabs(mtcars, aes(factor(carb), mpg, fill=factor(carb))) +
  geom_col() +
  labs(
    x = "carb",
    title = "Default Plot with Y-axis on the Right",
    subtitle = "My very long subtitle with many units",
    caption = "My very long plot caption with many references.")


# Equivalent to below
ggplot(mtcars, aes(factor(carb), mpg, fill=factor(carb))) +
  geom_col() +
  scale_brand_df() +
  guides(y=guide_axis(position="right")) +
  theme_brand(grid="XY")


if (FALSE) { # \dontrun{
brand_on()
} # }

gglabs(mtcars, aes(wt, mpg, color=carb), axes="topright") +
  geom_smooth(color=pal("red"), fill=pal("pink")) +
  geom_point(size=3) +
  labs(
    title = "My Beautiful Plot with X-axis at the Top",
    subtitle = "My descriptive subtitle with units",
    caption = "My plot caption with many references.")
#> `geom_smooth()` using method = 'loess' and formula = 'y ~ x'


gglabs(mtcars, aes(wt, mpg, color=factor(cyl)), 
  grid="XY", legend="bottom", base_family="Pacifico") +
  geom_point(size=3) +
  labs(
    x = "cyl",
    title = "My Plot with Full Gridlines and Pacifico Font",
    subtitle = "Placed the legend at the bottom",
    caption = "My plot caption with many references.")
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database
#> Warning: font family 'Pacifico' not found in PostScript font database