Communicate your results with Rmarkdown

Otho Mantegazza

2019-05-08

Tools for communcation

Rmarkdown, knitr, Shiny.

Why?

I’d second db connections and add RMarkdown. The tooling for generating reports with integrated plots is not as good in python.
— Hadley Wickham (@hadleywickham) February 21, 2019

Totally agree - I'm currently in a Python-heavy environment, and I think if anything tips the scales to including R in our workflow, it'll be RMarkdown.
— Jennifer Thompson (@jent103) February 21, 2019

🙆 a header (metadata)

title: "An rmarkdown report"
author: "Otho Mantegazza"

📝 some text (explain results)

# An example of rmarkdown

Below you'll find a very basic plot

💻 some code (produce results)

plot(mtcars$mpg, mtcars$hp)

How?

Code

hex-rmarkdown

Generate your results, plots.

text

hex-rmarkdown

Explain our results and the reasoning behind them.

Markdown

# This is a header

This is a paragraph. In my younger and more vulnerable years my father gave me
some advice that I've been turning over in my mind ever since.
"Whenever you feel like criticizing any one," he told me, "just remember that all
the people in this world haven’t had the advantages that you’ve had."

## This is a level 2 header

- this is a dotted list
- item 2
- item 3

This is another paragraph. Reserving judgments is a matter of infinite hope.
I am still a little afraid of missing something if I forget that, as my father
snobbishly suggested, and I snobbishly repeat, a sense of the fundamental
decencies is parceled out unequally at birth.

Markdown

### This is a level 3 header

1. This is an ordered list
2. item 2
1. item 3, dotted numbers are fixed automatically

### You can also add links and images/videos

[This is a link](https://en.wikiquote.org/wiki/The_Great_Gatsby)

![](path/to/image)

Markdown - Resources

📕 First version at Daring Fireball
📙 Basic Markdown at Rstudio
📗 Pandoc - A universal document converter

Let’s Try Some

In the rmarkdown file:

YAML header with metadata.
code is knitted in text with ```{language}
macheck the options for code output, for figures, tables etc.,
Also inline code.

🌻🌞 Check the examples/rmarkdown folder to see how to style the output 🌞🌻

Slides

These slides are made with Rmarkdown and revealjs, you can find the source code here

R code is evaluated:

summary(1:10)

##    Min. 1st Qu.  Median    Mean 3rd Qu.    Max. 
##    1.00    3.25    5.50    5.50    7.75   10.00

You can include maps 🌍.

library(leaflet)
library(tidyverse)


m <- leaflet() %>%
  addTiles() %>%  # Add default OpenStreetMap map tiles
  addMarkers(lng=174.768, lat=-36.852, popup="The birthplace of R")

🍃🍂This example is from the leaflet package.🍁🍀
⬇️ The output is below. ⬇️

More Books, Blogs, dashboards?

Full process

source: Rstudio

Resources

✍️ Yihui Xie’s Blog, developer of most of these tools,
💻 The official website, and Github repo
🔖 The Rmarkdown book,
📚 The Bookdown repository, with lots of books on R,
📈 D3 graphics,
👩‍🔬 The next level? Parametrized Rmarkdown and Rmarkdown driven development,
👨‍💻 My website, done with blogdown.

Interested in Tidytuesday?

The @R4DScommunity welcomes you to week 19 of #TidyTuesday! We're exploring Global Student-Teacher ratios!!

📁 https://t.co/sElb4fcv3u
🗞 https://t.co/nJqEUDyaNm #r4ds #tidyverse #rstats #dataviz pic.twitter.com/O5PZ7kTDiC
— Thomas Mock 👨🏼 💻 (@thomas_mock) May 6, 2019

Communicate your results with Rmarkdown

Otho Mantegazza

2019-05-08

Tools for communcation

Why?

How?

Code

text

Markdown

Markdown

Markdown - Resources

Let’s Try Some

Slides

More Books, Blogs, dashboards?

Full process

Resources

Interested in Tidytuesday?

Thank you!