# Rstudio

## Table of Contents

- Installing Rstudio
  - Linux (debian, ubuntu)
    - Installing R
    - Installing rstudio
  - Mac OSX and Windows

This document provides information on how to install Rstudio.

If you have never used git with Rstudio, we strongly advise that you follow our tutorial on using git from Rstudio ("Rstudio et Gitlab" in French). Before proceeding, make sure you also have followed the "git/GitLab configuration" tutorial (in French).

Alternatively, you may want to watch this video (in English). If you do not like videos, you should have a look at the step-by-step explanations from Software Carpentry. It comes with many screenshots and is quite progressive.

Last, you should know that the Rstudio team has created a lot of very good material and tutorials. You should definitively look at the Cheat sheets webpage. In particular you may want to have look at the following ones:

- The Rstudio IDE,
- R Markdown (here is also a nice step-by-step presentation of Rmarkdown),
- The R Markdown Reference guide,
- Data visualization with ggplot2,
- Data transformation with dplyr

In case it helps, here are some (sometimes outdated) French versions of these documents:

- L'IDE Rstudio
- Visualisation de données avec ggplot2
- Transformation de données avec dplyr
- Un court document sur R Markdown

## Installing Rstudio

### Linux (debian, ubuntu)

We provide here only instructions for debian-based distributions. Feel free to contribute to this document to provide up-to-date information for other distributions (e.g., redhat, fedora).

Today, the stable versions of the most common distributions provide recent enough versions of emacs and org-mode:

- Debian (stretch) ships with R 3.3.3-1, knitr 1.15.1, and ggplot 2.2.1
- Ubuntu (bionic 18.04) ships with R 3.4.4, and knitr 1.17, and ggplot 2.2.1
- Ubuntu (artful 17.04) ships with R 3.4.2, and knitr 1.15, and ggplot 2.2.1

If your distribution is older than this, well, it may be a good time for upgrading…

#### Installing R

Beforehand, you need to install the R language and convenient packages by running (as root):

    apt-get update ; sudo apt-get install r-base r-cran-knitr r-cran-ggplot2

Alternatively, if the installation of `r-cran-gplot2` or `r-cran-knitr` fails, you may want to install them locally (through the R packaging system) and manually by running the following commands in R (or Rstudio):

    install.packages("knitr")
    install.packages("ggplot2")

If you plan to export pdf documents with LaTeX, you probably also want to run (as root):

    apt-get update ; apt-get install texlive-base

#### Installing rstudio

Rstudio is unfortunately not packaged within debian so the easiest is to download the corresponding debian package on the Rstudio webpage and then to install it manually (depending on when you do this, you can obviously change the version number). Here is how to install it:

    cd /tmp/
    wget https://download1.rstudio.org/rstudio-xenial-1.1.453-amd64.deb
    sudo dpkg -i rstudio-xenial-1.1.453-amd64.deb
    sudo apt-get update ; sudo apt-get -f install # to fix possibly missing dependencies

### Mac OSX and Windows

> Some instructions on installing R and knitr must be missing. This should be tested and improved.

Download and install rstudio from the Rstudio webpage by choosing the right operating system.

Then open Rstudio and type the following commands in the console to install knitr and ggplot2:

    install.packages("knitr")
    install.packages("ggplot2")