Goals for today's session

• Obvious ones:

  • Learn about RMarkdown
  • Know how to write your thesis in RMarkdown

• Less obvious ones:

  • Know about the magic of knitr (support for other formats and other programming languages)
  • Learn how to get the best of all worlds (python, R, whatever other language)

Bonus: Ready to use template from us!

Why not just use Word?

Ever found yourself doing this every time you update your code?

Why not just use Word?

When using word, you're decoupling the coding and writing parts of your thesis:

Why not just use Word?

With RMarkdown, you're coding and writing in the same place.

Benefits of RMD over Word

You should use RMD, if

• you want to show output from code in your thesis
• you want the practical and aesthetic benefits of LaTeX

Benefits

• no more CTRL-C and CTRL-V to reflect changes
• LaTeX is much less administrative effort for formatting/alignment in larger projects like a thesis

Benefits of RMD over Word

The work process in Word (for every individual chart):

Change Chart in R -> Write to .png -> Copy into Word -> Align

If you realise you made a mistake in your early data preprocessing, you'll have to do it all over again for all charts every time!

Not in RMD!

RMarkdown

Your turn

Open an RMarkdown file in RStudio:

File -> New File -> RMarkdown -> Give it a title -> Choose output format PDF

Save this document somewhere you'll find it again.

You need a LaTeX distribution to make it work. Luckily, R makes it easy for us. Run the following in your console:

install.packages("tinytex")
tinytex::install_tinytex()

Then, let's inspect what we're looking at.

How do you write your thesis with this?

A program for your thesis needs to fulfil the following points:

• Title page
• Table of contents
• Table of figures
• Page numbering
• Citations
• References
• ...

RMarkdown does all of this, because you can use raw LaTeX. This is where the magic happens: You can combine your code and the power of LaTeX to generate research papers.

Let's take a look

Download the template from the resources section on our website and extract the main folder from the ZIP folder.

The Parent Document

Open FirstName-LastName-12345678.pdf. Let's take a look together

The Parent Document

Open FirstName-LastName-12345678.rmd. Let's take a look together

The Parent Document

Let's knit it once. Doing this the first time, the LaTeX distribution first installs the necessary packages from the YAML, this takes a few minutes. The next knit will take much less time.

The Children

The Children

The following chunk in the parent document "pulls in" the information in the child document. Hence, the parent functions as the global hub for knitting, also setting all formatting and applying it equally to all children.

```{r intro, child = 'introduction.rmd'}
```

Always knit from the parent document. This takes a little getting used to, but you'll get around to it.

Basic tools

Open introduction.rmd and keep the PDF open. Let's take a look at this together.

So let's recap

We wanted:

• Title page
• Table of contents
• Table of figures
• Page numbering
• Citations
• References
• ...

And most importantly: No more manual copying and pasting.

That's it for today!

We hope this tutorial was useful! Feel free to make use of the template and don't despair if you encounter errors. For further questions, feel free to reach out to us. Make sure to stay updated on our socials and via our website where all resources and dates are also published.