Data Science Workflow: Communicate

Necessary packages

Installation

install.packages(knitr)
install.packages(rmarkdown)

Introduction to R Markdown

• R Markdown is a file format for making dynamic documents with R.

• R Markdown allows you to organize your code, outputs, content and commentary in one place.

• These documents are self-contained and fully reproducible which makes it very easy to share.

• R Markdown document is written in markdown.

• Markdown is one of the world's most popular markup language.

  • R Markdown (in R)
  • Jupyter Notebooks (in Python)

Advantages

1. For communicating to decision makers, who want to focus on the results and conclusions, not the code behind the analysis.

2. For collaborating with other data scientists, who are interested in both your conclusions, and how you reached them (i.e. the codes that you used to take the outputs).

3. As an environment in which to do data science, as a modern day lab notebook where you can capture not only what you did, but also what you were thinking.

From R for Data Science by Hadley Wickham and Grrett Grolemud.

Select a folder to save the document

Give a name to the document

Change header

# Header 1
## Header 2
### Header 3

Add content

# Header 1
This is section 1.
## Header 2
This is section 1.2
### Header 3
This is section 1.2.1

Add R codes

# Header 1
This is section 1.
## Header 2
This is section 1.2
### Header 3
This is section 1.2.1

rnorm(2)

## [1] 1.6271067 0.3843959

Chunk options

• eval = FALSE - prevents the code from being evaluated

• include = FALSE - runs the code but doesn't show it in the final document

• echo = FALSE - prevents the code but not the results from appearing

• message = FALSE - prevents messages from appearing in the finished file

• results = "hide" - hides the printed output

• error = TRUE - causes the render to continue even if the code returns an error

Text formatting

Mathematical Equations

The code:

Output:

The general formula for the probability density function of the normal distribution with mean $\mu$ and variance $\sigma$ is given by

$$f_X\left(x\right)=\frac{1}{\sigma \sqrt{\left(2\pi \right)}}{e}^{-(x-\mu {)}^2/2{\sigma }^2}.$$

How to type Greek letters?

Please read my blog post here:

https://thiyanga.netlify.app/post/greekletters/

Generate PDF and WORD documents

tinytex::install_tinytex()

R Markdown Demonstration

Download Rmarkdown_practical_lesson1.Rmd

Download sampleimage.jpg

Before running the file Rmarkdown_practical_lesson1.Rmd, save Rmarkdown_practical_lesson1.Rmd and sampleimage.jpg into your current working directory.

Follow the video lecture for instructions.