Type:	Package
Title:	Steve's 'ggplot2' Themes and Related Theme Elements
Depends:	R (≥ 3.5.0)
Version:	0.1.0
Maintainer:	Steve Miller <steven.v.miller@gmail.com>
Description:	This is a compilation of my preferred themes and related theme elements for 'ggplot2'. I believe these themes and theme elements are aesthetically pleasing, both for pedagogical instruction and for the presentation of applied statistical research to a wide audience. These themes imply routine use of easily obtained/free fonts, simple forms of which are included in this package.
URL:	http://svmiller.com/stevethemes/
BugReports:	https://github.com/svmiller/stevethemes/issues
License:	MIT + file LICENSE
Encoding:	UTF-8
LazyData:	true
RoxygenNote:	7.2.3
Imports:	ggplot2 (≥ 3.3.0), rlang (≥ 1.0.0), systemfonts
NeedsCompilation:	no
Packaged:	2023-01-31 08:01:04 UTC; steve
Author:	Steve Miller [aut, cre], Accademia di Belle Arti di Urbino [ctb] (Principal design of Titillium Web font), Steve Matteson [ctb] (Designer of Open Sans), Erik Spiekermann [ctb] (Designer of Fira Sans), Ralph du Carrois [ctb] (Designer of Fira Sans), Sebastian Kosch [ctb] (Design initiator for Crimson Pro), Jacques Le Bailly [ctb] (Designer of Crimson Pro)
Repository:	CRAN
Date/Publication:	2023-01-31 16:50:02 UTC

Miscellaneous functions for fine-tuning ggplot2 plots

Description

These are assorted functions that will fine-tune various things in a ggplot2 plot.

Usage

adj_font_size(x, ...)

Arguments

Details

adj_font_size() is a simple wrapper for some basic ggplot2 code that will allow you to adjust the font size on the plot by some number.

Right now, adj_font_size() assumes you are using theme_steve() because the font sizes initialized in the function are defaults from the theme.

Value

adj_font_size() takes a plot made in ggplot2 and changes the font size by some number requested by the user. It returns a plot with bigger or smaller fonts, per the user's request.

Author(s)

Steven V. Miller

Examples

library(ggplot2)

example_plot(type = "scatter") + adj_font_size(-2)

example_plot(type = "scatter") + adj_font_size(2)

Create an example plot (in ggplot2) for experimenting with different styles

Description

example_plot() allows you to experiment with some ggplot2 themes, like those in this package, by seeing them applied to some example plots.

Usage

example_plot(type = "bar")

Arguments

Details

I'll add more here in a little bit.

Value

example_plot() returns a plot made in ggplot2, allowing the user to experiment with different themes to see which ones they like the best.

Author(s)

Steven V. Miller

Examples

library(ggplot2)

example_plot()

example_plot(type = "faceted_line")

example_plot(type = "scatter")

Get a Custom Color from steve_hex

Description

g_c() (i.e. *g*et *c*olor) is a simple function that interfaces with the steve_hex data frame to return a hex value associated with a named color.

Usage

g_c(x)

Arguments

Details

Check steve_hex in this same package for the custom colors included

Value

g_c() returns a character vector, in particular, a hex triplet that coincides with the label supplied in the function. Use it for specifying a custom fill or color in a plot.

Author(s)

Steven V. Miller

Examples

g_c("su_blue")

g_c("martel_pink")

Kilowatt Hours per Capita and GDP per Capita, 2010

Description

This is a simple data frame of the GDP per capita and kilowatt hours consumed per capita of over 130 sovereign states in 2010.

Usage

kwh_gdp

Format

A data frame the following 7 variables.

country

the name of the country

iso3c

the three-character ISO code of the country

year

the year of observation (2010)

kwhpc

the electric power consumption (kilowatt hours) per capita of the country

gdppc

the GDP per capita of the country in current USD

ln_kwhpc

the (log-transformed) electric power consumption (kilowatt hours) per capita of the country

ln_gdppc

the (log-transformed) GDP per capita of the country in current USD

Details

Data come from a use of the WDI() function in the WDI package. The GDP per capita data come from a combination of the World Bank and OECD. The energy consumption data come from the International Energy Agency. Data exist to be used in a simple scatterplot.

CAGEMATCH Ratings of Rick Martel

Description

This is a simple data frame of ratings (on a 1-10 scale) of Rick Martel.

Usage

martel_ratings

Format

A data frame the following 2 variables.

date

a date vector for when the rating was posted on CAGEMATCH

value

an individual person's rating of Rick Martel (on a 1-10 scale)

Details

Data exist to be used an example bar chart. CAGEMATCH (stylized in all caps) is an internet wrestling database, for which these ratings are fan submissions. Rick Martel is an objective 10/10.

Miscellaneous functions to make your ggplot2 plot "print-ready"

Description

These are assorted functions that will make your plot "print-ready" by removing gridlines and giving hard-line axes to the plot. These are typically changes requested by publishes for the printing process.

Usage

no_gridlines(...)

make_classic(...)

Arguments

Details

no_gridlines() is a simple wrapper for some basic ggplot2 code that will allow you to remove gridlines from the plot. make_classic() removes gridlines, removes the default gray background, *and* imposes a black, solid line on both axes. It will also hard code the axis text to be black. Using the latter with the former is likely redundant.

You will want to put these functions after a theme you've declared. If you run this before adding a theme over it, the theme you add will probably overwrite this function.

Value

no_gridlines() takes a plot made in ggplot2 and removes the gridlines from the plot before returning it to the user. make_classic() takes a plot made in ggplot2 and removes the gridlines, gray background, and adds solid axes to the plot.

Author(s)

Steven V. Miller

Examples

library(ggplot2)

example_plot(type = "scatter")

example_plot(type='scatter') + no_gridlines()

example_plot(type='scatter') + make_classic()

GDP per Capita of Swedish Counties, 2001-2020

Description

This is a simple data frame of the GDP per capita of Swedish counties from 2001 to 2020.

Usage

se_counties_gdppc

Format

A data frame the following 4 variables.

nuts

the Nomenclature of Territorial Units for Statistics (NUTS) code for the county

county

the name of the county

year

the year of observation

value

the GDP per capita of the county in nominal SEK

Details

Data come from the OECD and exist to be used as a faceted line chart.

Some Hex Triplets I Find Useful/Interesting/Fun

Description

This is a simple data frame with labels corresponding to hex triplets (i.e. web colors) that I find useful, interesting, or fun.

Usage

steve_hex

Format

A data frame the following 2 variables.

color

a character vector describing the color in question

hex

a hex triplet (with preceding hashtag) of the color

Details

Data exist to be used by g_c() in this same package.

Steve's Preferred ggplot2 Themes and Assorted Stuff

Description

theme_steve() is my default theme framework for graphs I make with ggplot2. It starts theme_bw(), which is available in ggplot2, but adjusts the margins and axes a bit to my liking. The end result is, I think, a lovely template for graphs I make in R.

Usage

theme_steve(style = "web", font, ...)

Arguments

Details

The best use of this function may involve the fonts you have installed on your system. The user should experiment with various options to see what they like. The "generic" style will use default ggplot2 fonts.

Value

No return value. Function is used for its side effect, which is to format a plot made in the ggplot2 package.

Examples

library(ggplot2)

# Experiment with options, those this depends on fonts you have installed.
example_plot() + theme_steve(style='generic')