TITLE: Customising plots drawn to estimate pairwise marginal means comparisons with emmeans::pwpp()
DATE: 2019-08-07
AUTHOR: John L. Godlee
====================================================================


For a paper I’ve been writing I was running linear mixed effects
models with categorical fixed effects to compare the amount of pine
weevil damage present in different forest sites. To evaluate my
models, I wanted to run pairwise comparisons between sites in the
model to see which sites were significantly different. I decided to
run a Tukey’s HSD (Honestly Significant Difference) test on
Estimated Marginal Means of sites in the model. I’m doing my
analysis in R, so all the code is R code.

I used emmeans::emmeans() to calculate the EMMs, which returns a
special object of class emmGrid. emmeans::pwpp() is a handy function
to create and plot the results from a Tukey’s HSD (or other test
method) pairwise comparison of the EMMs, with P-value along the x
axis and categories along the y axis. Lines connect pairwise
categories and are placed along the x axis to denote the
significance of their difference.

The basic plot is fine, and is certainly useful for interpretation,
but I want to include the plots in my paper and they look a bit too
much like the ggplot() default. The plotting method also makes it
difficult to customise the plot. The basic code to produce the plot
is below:

    # Packages
    library(glmmTMB)
    library(emmeans)
    library(ggplot2)

    # Import data
    df <- read.csv("~/Desktop/pwpp_data.csv")

    # Run mixed effects model
    mod <- glmmTMB(mm2_damage ~ site_code + (1|family),
      data = df)

    # Estimate Marginal Means
    tukey <- emmeans(mod, "site_code")

    # Run Pairwise compari
    pwpp_results <- pwpp(tukey, values = TRUE, sort = FALSE)

    # Look at basic plot
    pwpp_results

The plot looks like this:

  {IMAGE}


As the object pwpp_results is a glorified ggplot() object, it’s
possible to extract the data used to make the plot and store it in
tidy dataframes:

    # Extract data from plot object
    marg_vals <- data.frame(
      y = pwpp_results$layers[[3]]$data$site_code, 
      label = pwpp_results$layers[[3]]$data$fmtval)

    p_vals <- data.frame(
      x = pwpp_results$data$p.value, 
      plus = pwpp_results$data$plus, 
      minus = pwpp_results$data$minus, 
      midpt = pwpp_results$data$midpt)

marg_vals holds data on the marginal values for each category, which
appear as labels down the left hand side of the plot. p_vals
contains data for drawing the lines.

I also wanted to create a colour palette for my customised plot,
which I made [here, at Colorgorical]:

  [here, at Colorgorical]: http://vrl.cs.brown.edu/color

    # Create colour palette
    site_pal <- c("#270fe2", "#75ae0a", "#b427b7", "#14e54b",
      "#8e4380", "#0b5313", "#d992e2", "#7ba979",
      "#fc2c44", "#1ce0b2", "#900e08", "#37bad7")

I can then create the plot:

    pwpp_ggplot <- ggplot() + 
      geom_segment(data = p_vals,
        aes(x = x, xend = x, y = plus, yend = midpt, colour = minus)) +
      geom_point(data = p_vals,
        aes(x = x, y = plus, colour = minus), 
        size = 3) + 
      geom_label(data = marg_vals, 
        aes(x = 0.01, y = y, label = label),
        label.padding = unit(0.15, "lines"), hjust = "right") +
      geom_vline(aes(xintercept = 0.05),
        linetype = 2) + 
      ylab("Site") +
      xlab("Tukey-adjusted P value") + 
      theme_classic() +
      theme(panel.grid.major.y = element_line(colour="#E0E0E0"),
        axis.title = element_text(size = 14),
        axis.text = element_text(size = 12),
        axis.text.y = element_text(colour = site_pal),
        legend.position = "none") + 
      scale_x_continuous(breaks = c(0, 0.05, 0.1, 0.5, 1)) + 
      scale_colour_manual(values = site_pal) + 
      coord_trans(x = "log10", clip = "off")

geom_segment draws the lines. Each line is actually composed of two
line segments which meet at p_vals$midpt and are coloured according
to the opposite point.

geom_label plots the marginal values, which are placed at x = 0.01
and are right aligned so they are unlikely to overlap a comparison
line.

geom_vline denotes the p = 0.05 significance line.

panel.grid.major.y draws lines for each category, which helps when
reading the graph and matching line ends with categories.

scale_x_continuous marks breaks for a number of common significance
thresholds.

coord_trans log transforms the x axis so that lines near the low end
of the P value scale are more spaced out, as they are more important
for interpretation, clip = "off" ensures that the full range of P
values is shown, so plots are interpretable across models with
different categories.

The final plot looks like this:

  {IMAGE}