rmarkdown Introduction David Dalpiaz STAT 430, Fall 2017 1

Announcements • Homework 00 has been released • Be sure to read homework policies document! • Optional but highly recommended • Begin Quiz review problems • Solutions not provided, be sure to take notes! • Reading and Videos • Read! Watch! Review! 2

Markdown • Markdown allows you to write a file format independent document using an easy-to-read and easy-to-write plain text format. • Instead of marking up text so that is easy for a computer to read. . . • e.g. HTML: <html><body><b>Name</b></body></html> • The goal is to mark down text so that is human readable: • e.g. **Name** 3

Example Markdown Document 4

Supported Output Files As a result of Markdown being structured so loosely, any file format can be generated using pandoc. That is to say, from one Markdown document you can generate any of the following: • docx • PDF • HTML • ODT • RTF The downside is that there is slightly less control over formatting, but it is well worth it. 5

RMarkdown RMarkdown developed by RStudio takes what Markdown has established and extends it significantly by: • Allowing R code and its results to be merged with Markdown; • Ensuring that RMarkdown documents are fully reproducible; • Enabling extra modifications to original markdown specification. 6

Creating an RMarkdown Document To create an RMarkdown or .Rmd Document within RStudio: Click the Enter Document Title White Plus Select R Markdown 7

Initial RMarkdown View 8

Compiling RMarkdown Document Use either: • An RStudio shortcut • Windows: Ctrl + Shift + K • macOS: Command + Shift + K • The “Knit ..” button on the source editor window • Or, compile the document via rmarkdown::render() • more on this later. . . 9

Sample Render of Default RMarkdown View 10

Sections of an RMarkdown Document There are principally three sections to an RMarkdown document. • YAML header • Code chunks • Copious amounts of text! 11

Options. . . Options. . . Options. . . Some of RMarkdown’s output options can be configured via a GUI in RStudio 1 1 To see all the options granted by RMarkdown, check out the package website at: http://rmarkdown.rstudio.com/ . 12

Dynamic Code Chunks To initiate a code chunk within RMarkdown, all one needs to do is use: ```{r chunk_label} # Code here ``` Example: Here we will embed the output of obtaining 10 random numbers. ```{r chunk_demo} x = runif(10) print(x) ``` 13

Examples of Markdown syntax Writing text with emphasis in *italics*, **bold** and `code style`. Line breaks create a new paragraph. Links can be hidden e.g. [illinois](www.illinois.edu) or not <http://illinois.edu> . Sample Image: ![Illinois](img/wordmark_vertical.png) 14

Rendered Example of Markdown syntax Writing text with emphasis in italics , bold and code style . Line breaks create a new paragraph. Links can be hidden e.g. illinois or not http://illinois.edu . Sample Image: 15

Examples of Markdown syntax (Con’t) > "Never gonna give you up, never gonna let you down..." > > --- Rick Astley - generic - bullet point - listing 1. Ordered number list 1. is numbered 42. correctly Inline math $a^2 + b^2 = c^2$ Display math (centered math) $$1 - x = y$$ 16

Rendered Example of Markdown syntax (Con’t) “Never gonna give you up, never gonna let you down. . . ” — Rick Astley • generic • bullet point • listing 1. Ordered number list 2. is numbered 3. correctly Inline math a 2 + b 2 = c 2 Display math (centered math) 1 − x = y 17

Why? Literate Programming Reproducible Research 18

rmarkdown Live Coding Let’s try it! 19

rmarkdown Introduction David Dalpiaz STAT 430, Fall 2017 1 - PowerPoint PPT Presentation

rmarkdown Introduction David Dalpiaz STAT 430, Fall 2017 1 Announcements Homework 00 has been released Be sure to read homework policies document! Optional but highly recommended Begin Quiz review problems Solutions not

Workflow basics, RMarkdown, git/Github Cleaning up Cleaning up Cleaning up Cleaning up

MAKING REPRODUCIBILITY PRACTICAL USING RMARKDOWN AND R (+ MORE ) Melinda Higgins, PhD;

Automating our work away One consulting firms experience with RMarkdown Finbarr Timbers 1 2

INTRODUCTION INTRODUCTION INTRODUCTION INTRODUCTION INTRODUCTION INTRODUCTION INTRODUCTION

INTRODUCTION Introduction 2/42 INTRODUCTION Alternations I am giving bread to the

Introduction Introduction Introduction Introduction Outline Motivation Failures

Introduction Introduction Introduction Nationwide Cause for Concern 1

DAQ introduction Purpose of this talk : (1) Introduction for those who have not been in every

INTRODUCTION cf. Schneider, Chapter 1 INTRODUCTION THEY ARE OUT TO GET YOU INTRODUCTION WHAT

Overview Introduction to SMIL Introduction to W3C and XML Introduction to SMIL

14 Introduction Introduction Bad guys can put malware into Example: hosts

Previous Lecture Introduction to SMIL 2 Introduction to W3C and XML Introduction to SMIL

Lecture 1 Andreas Habegger Introduction Zynq Introduction Zynq Introduction Zynq PS vs. PL

2018.06 01 SMILE5 Introduction S E 5 02 Alpha Cloud M I L 03 Company Introduction 04

Introduction to CICS Course introduction Course introduction What is CICS? What is an

Network Visualization Introduction Presented by Shahed Introduction Introduction Basic

Introduction Introduction (1) Main argument of the paper: universities are not only

Introduction Introduction to storage and to storage and filesystems filesystems Introduction

JABLOTRON JA-100 introduction November 2011 Introduction Todays goals First introduction of

1 Introduction Introduction Communication System Baseband an adjective that describes

Welcome! Todays Agenda: Topic Introduction Course Introduction Team Practical

Introduction (00) RNDr. Martin Madaras, PhD. madaras@skeletex.xyz Introduction Introduction

PRESENTATION The Introduction What is the Introduction ? The introduction prepares the audience

How to make a presentation with L A T EX? Introduction to L A T EX Introduction to Beamer