10  Customising your figures

For a scientific report to be completely credible, it must be reproducible. The full computational environment used to derive the results, including the data and code used for statistical analysis should be available for others to reproduce. quarto is a tool that allows you integrate your code, text and figures in a single file in order to make high quality, reproducible reports. A paper published with an included quarto file and data sets can be reproduced by anyone with a computer.

When you produce figures, you usually want to tweak them a little bit. A bit wider, perhaps a bit taller. Perhaps a different image type other than “png”, because the journal requires “TIFF” or “EPS”. Maybe you need 600dpi because you’re going to print it really big. So, how do you control these features?

You can control the size and features of figures with the chunk options. In this section, we are going to talk more specifically about how to customise your figures.

10.1 Overview

  • Teaching 10 minutes
  • Exercises 10 minutes

10.2 Questions

  • How do I change the height and width of a figure?
  • How to I change the type of output of a figure? (e.g., PDF, TIFF, PNG, JPG, SVG)
  • Can I set all the figure features globally?
  • How do I save the figures?

10.3 Objectives

  • Learn how to set individual figure height, width, aspect, and print size
  • Learn how to set global parameters for your chunks
  • Get a copy of all of your figures

10.4 Which chunk options should you care about for this?

There are many chunk options that control your output, but only a few that you really need to worry about for your figures:

  • fig.align: How do you want your figure aligned? Takes one of the following inputs: “default”, “center”, “left”, or “right”? (demo)
  • fig.cap: Would you like a caption for your figure? It takes a character vector as input: “My Amazing Graph”
  • fig.height & fig.width: How tall and wide would you like your figure in inches? Each takes one number (e.g., 7, or 9) [Note: these numbers are not quoted]
  • out.height & out.width: The height and width of your plot in the final file. This can be handy if you like the current aspect ratio of your plot, but you want to shrink it by say 50% - which you would do with “50%”. You can also include LaTeX output or HTML output. Say for example, “.8//linewidth” or “8cm” for LaTeX, or “300px” for HTML.

For demonstration purposes, let’s take a plot from earlier and show how it’s output can change.

  • with fig.height, fig.width, out.width, dev

10.4.1 Your Turn

  1. Open exercise exercises/02-rmd-figures-chunks/02-rmd-figures-chunks.Rmd Create three figures, with the respective dimensions (fig.height and fig.width)
    • 2x2
    • 10x10
    • 4x7
  2. Now add to those figures, the following:
    • fig.align = "center"
    • out.width = 50%

10.5 Setting global options

If we repeat adding the same chunk options for each figure, we might want to consider setting them globally. We can do this with the following code:

knitr::opts_chunk$set(chunk_option1 = TRUE, ...)

(As mentioned earlier), I typically set this up in a code chunk at the start of a document.

10.5.1 Your Turn

  1. Set the global options in your document to set:
  • fig.height
  • figh.width
  • dev

10.6 Keeping your figures

You can set the options for your figures, which will change how they appear on the page, but this won’t save the figures anywhere. In order to save the figures to file, you need to edit the YAML option keep_md: true:

---
title: "Awesome report"
author: "You"
output:
  html_document:
    keep_md: true
---

You’ll notice that this creates some folders called “FILENAME_files” - you can control the specific name of the folder by setting fig.path like so:

knitr::opts_chunk$set(fig.path = "figs")

Which would instead create a new folder aclled “figs”.

10.7 Your Turn

  1. Save your images in your document by setting keep_md: true

10.8 Further Reading