theme_jam: Jam default theme for ggplot2

In jmw86069/colorjam: Jam Color manipulation functions

Jam default theme for ggplot2

Description

Jam default theme for ggplot2

Usage

theme_jam(
  theme_default = ggplot2::theme_bw,
  base_size = 18,
  grid.major.size = 0.5,
  grid.minor.size = 0.25,
  strip.background.colour = "grey30",
  strip.background.fill = "lightgoldenrod1",
  strip.text.size = ggplot2::rel(0.8),
  panel.grid.major.colour = "grey80",
  panel.grid.minor.colour = "grey90",
  panel.background = ggplot2::element_rect(fill = "white", colour = NA),
  panel.border = ggplot2::element_rect(fill = NA, colour = "grey15"),
  axis.text.x.angle = 60,
  blankGrid = FALSE,
  blankXgrid = FALSE,
  blankYgrid = FALSE,
  resetTheme = TRUE,
  verbose = FALSE,
  ...
)

Arguments

theme_default	function representing a ggplot2 theme.
base_size	numeric default font point size, used for scaling the overall text sizes larger or smaller.
grid.major.size, grid.minor.size	numeric the line width for the major and minor grid lines, respectively. Set to 0 to suppress either.
strip.background.colour, strip.background.fill	character color for the border and strip background itself when ggplot2 is using a faceted layout.
strip.text.size	numeric or relative class ggplot2::rel() to define direct or relative text font size, respectively.
panel.grid.major.colour, panel.grid.minor.colour	character colors for the major and minor grid lines, respectively.
panel.background, panel.border	element_rect or NULL indicating the type of background or border to draw around each plot panel. When set to NULL it is set to ggplot2::element_blank() which displays nothing.
axis.text.x.angle	numeric degrees to rotate the x-axis labels, apparently starts at 0 (horizontal) and goes counter-clockwise (to the left.)
blankGrid, blankXgrid, blankYgrid	logical indicating whether to have a blank grid for everything, major, or minor axis lines, respectively. Intended to make it fast and easy to remove all gridlines.
resetTheme	logical whether to call the function theme_default which essentially resets (replaces) all previous settings with those defined in the theme function. If FALSE then only the specific settings defined in this function will be applied.
verbose	logical indicating whether to print verbose output.
...	additional arguments are passed to ggplot2::theme() in order to allow custom settings beyond what this function provides.

Details

This function applies some default theme settings to ggplot2, mainly taking away the default grey newspaper background color, also rotates the x-axis label text to 60 degrees, to accomodate longer labels without overlaps.

See Also

Other colorjam ggplot2: jam_pal(), scale_color_jam(), scale_fill_jam()

Examples

if (jamba::check_pkg_installed("ggplot2")) {
   dsamp <- ggplot2::diamonds[sample(nrow(ggplot2::diamonds), 1000),];
   d <- ggplot2::ggplot(dsamp,
      ggplot2::aes(carat, price)) +
      ggplot2::geom_point(
         ggplot2::aes(colour=cut),
         size=2);

   print(d + scale_color_jam() + ggplot2::ggtitle("scale_color_jam()"));
   print(d + scale_color_jam() + theme_jam() + ggplot2::ggtitle("scale_color_jam() + theme_jam()"));
}

jmw86069/colorjam documentation built on Dec. 16, 2024, 8:02 a.m.