Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.

This is a follow up to a twitter-gist post & to the annotation party we’re having this week

I had not intended this to be “Annotation Week” but there was a large, positive response to my annotation “hack” post. This reaction surprised me, then someone pointed me to this link and also noted that if having to do subtitles via hacks or Illustrator annoyed me, imagine the reaction to people who actually do real work. That led me to pull up my ggplot2 fork (what, you don’t keep a fork of ggplot2 handy, too?) and work out how to augment ggplot2-proper with the functionality. It’s yet-another nod to Hadley as he designed the package so well that slipping in annotations to the label, theme & plot-building code was an actual magical experience. As I was doing this, @janschulz jumped in to add below-plot annotations to ggplot2 (which we’re calling the caption label thanks to a suggestion by @arnicas).

### What’s Changed?

There are two new plot label components. The first is for subtitles that appear below the plot title. You can either do:

ggtitle("The Main Title", subtitle="A well-crafted subtitle")

or

labs(title="The Main Title", subtitle="A well-crafted subtitle")

The second is for below-plot annotations (captions), which are added via:

labs(title="Main Title", caption="Where this crazy thing game from")

These are styled via two new theme elements (both adjusted with element_text()):

• plot.subtitle
• plot.caption

A “casualty” of these changes is that the main plot.title is now left-justified by default (as is plot.subtitle). plot.caption is right-justified by default.

### Yet-another ggplot2 Example

I have thoughts on plot typography which I’ll save for another post, but I wanted to show how to use these new components. You’ll need to devtools::install_github("hadley/ggplot2") to use them until the changes get into CRAN.

I came across this chart from the Pew Research Center on U.S. Supreme Court “wait times” this week:

It seemed like a good candidate to test out the new ggplot2 additions. However, while Pew provided the chart, they did not provide data behind it. So, just for you, I used WebPlotDigitizer to encode the points (making good use of a commuter train home). Some points are (no doubt) off by one or two, but precision was not necessary for this riff. The data (and code) are in this gist. First the data.

library(ggplot2)   dat <- read.csv("supreme_court_vacancies.csv", col.names=c("year", "wait"))

Now, we want to reproduce the original chart “theme” pretty closely, so I’ve done quite a bit of styling outside of the subtitle/caption. One thing we can take care of right away is how to only label every other tick:

xlabs <- seq(1780, 2020, by=10) xlabs[seq(2, 24, by=2)] <- " "

Now we setup the caption. It’s long, so we need to wrap it (you need to play with the number of characters value to suit your needs). There’s a Shiny Gadget (which is moving to the ggThemeAssist package) to help with this.

caption <- "Note: Vacancies are counted as the number of days between a justice's death, retirement or resignation and the successor justice's swearing in (or commissioning in the case of a recess appointment) as a member of the court.Sources: U.S. Senate, 'Supreme Court Nominations, present-1789'; Supreme Court, 'Members of the Supreme Court of the United States'; Pew Research Center calculations" caption <- paste0(strwrap(caption, 160), sep="", collapse="n")

We’re going to try to fully reproduce all the annotations, so here are the in-plot point labels. (Adding the lines is an exercise left to the reader.)

annot <- read.table(text= "year|wait|just|text 1848|860|0|Robert Cooper Grier was sworn in Aug 10, 1846,841 days after the death of Henry Baldwin 1969|440|1|Henry Blackmun was swornin June 9, 1970, 391 daysafter Abe Fortas resigned. 1990|290|0|Anthony Kennedywas sworn in Feb.18, 1988, 237days after LewisPowell retired.", sep="|", header=TRUE, stringsAsFactors=FALSE) annot$text <- gsub("", "n", annot$text)

Now the fun begins.

gg <- ggplot() gg <- gg + geom_point(data=dat, aes(x=year, y=wait))

We’ll add the y-axis “title” to the inside of the plot:

gg <- gg + geom_label(aes(x=1780, y=900, label="days"), family="OpenSans-CondensedLight", size=3.5, hjust=0, label.size=0, color="#2b2b2b")

Now, we add our lovingly hand-crafted in-plot annotations:

gg <- gg + geom_label(data=annot, aes(x=year, y=wait, label=text, hjust=just), family="OpenSans-CondensedLight", lineheight=0.95, size=3, label.size=0, color="#2b2b2b")

Then, tweak the axes:

gg <- gg + scale_x_continuous(expand=c(0,0), breaks=seq(1780, 2020, by=10), labels=xlabs, limits=c(1780,2020)) gg <- gg + scale_y_continuous(expand=c(0,10), breaks=seq(100, 900, by=100), limits=c(0, 1000))

Thanks to Hadley’s package design & Jan’s & my additions, this is all you need to do to add the subtitle & caption:

gg <- gg + labs(x=NULL, y=NULL, title="Lengthy Supreme Court vacancies are rare now, but weren't always", subtitle="Supreme Court vacancies, by duration", caption=caption)

Well, perhaps not all since we need to style this puppy. You’ll either need to install the font from Google Fonts or sub out the fonts for something you have.

gg <- gg + theme_minimal(base_family="OpenSans-CondensedLight") # light, dotted major y-grid lines only gg <- gg + theme(panel.grid=element_line()) gg <- gg + theme(panel.grid.major.y=element_line(color="#2b2b2b", linetype="dotted", size=0.15)) gg <- gg + theme(panel.grid.major.x=element_blank()) gg <- gg + theme(panel.grid.minor.x=element_blank()) gg <- gg + theme(panel.grid.minor.y=element_blank()) # light x-axis line only gg <- gg + theme(axis.line=element_line()) gg <- gg + theme(axis.line.x=element_line(color="#2b2b2b", size=0.15)) # tick styling gg <- gg + theme(axis.ticks=element_line()) gg <- gg + theme(axis.ticks.x=element_line(color="#2b2b2b", size=0.15)) gg <- gg + theme(axis.ticks.y=element_blank()) gg <- gg + theme(axis.ticks.length=unit(5, "pt")) # breathing room for the plot gg <- gg + theme(plot.margin=unit(rep(0.5, 4), "cm")) # move the y-axis tick labels over a bit gg <- gg + theme(axis.text.y=element_text(margin=margin(r=-5))) # make the plot title bold and modify the bottom margin a bit gg <- gg + theme(plot.title=element_text(family="OpenSans-CondensedBold", margin=margin(b=15))) # make the subtitle italic gg <- gg + theme(plot.subtitle=element_text(family="OpenSans-CondensedLightItalic")) # make the caption smaller, left-justified and give it some room from the main part of the panel gg <- gg + theme(plot.caption=element_text(size=8, hjust=0, margin=margin(t=15))) gg

That generates:

All the annotations go with the code. No more tricks, hacks or desperate calls for help on StackOverflow!

Now, this does add two new elements to the underlying gtable that gets built, so some other StackOverflow (et al) hacks may break if they don’t use names (these elements are named in the gtable just like their ggplot2 names). We didn’t muck with the widths/columns at all, so all those hacks (mostly for multi-plot alignment) should still work.

All the code/data is (again) in this gist.