Zoom Notes 06: Communicating Data

Associated Material

Module: Module 06 - Communicate

Readings:

• R for Data Science - Chapter 27
• R for Data Science - Chapter 29
• Reference: RMarkdown - the definitive guide
• RMarkdown Reference Guide

What is RMarkdown

There are three main components to an RMarkdown document

1. The YAML header which is surrounded by ---s and provides information for the compiling process
2. R code chunks which are surrounded by ```s
3. Text which can be formatted using the Markdown language.

A reference guide of RMarkdown syntax can be found through Help -> Cheat Sheets -> R Markdown Reference Guide in the RStudio menu.

Example Rmd

Create your own RMarkdown document now from the template. To do this go File -> New File -> R Markdown.

Knitting

“Knit” or compile the document using the knit button or Ctrl + Shift + K.

Markdown syntax

Refer to the RMarkdown Reference Guide

Code Chunks

Code chunks look like:

```{r}
1 + 2
```

• Code chunks are executed as part of the document “knitting” and the code and output embedded in the document

• Be aware of the working directory (don’t use setwd()). Ideally use the here package to manage paths.

Images, Figures, and Tables

• Images can be included though markdown, or by using the include_graphics() from knitr in a code chunk - the latter provides more options for customising for size/position.

• Figures are created from code chunks and chunk options are used to control size/position

• Tables can be manually created using the markdown syntax or created automatically from your data using the kable() from knitr.

Further customising of kable tables can be done with the kableExtra package.

Citations

Citations can be inserted into an RMarkdown document. This document from RStudio goes through how to do it