README.md

title: Initiation à R à travers RStudio
author: Vincent Navratil (vincent.navratil@univ-lyon1.fr)
[[_TOC_]]

<a href="https://rstudio.com"><img src="https://d33wubrfki0l68.cloudfront.net/62bcc8535a06077094ca3c29c383e37ad7334311/a263f/assets/img/logo.svg" width=200px></a>

## Prérequis
- pas de connaissance de base sur les lignes de commandes et R

# Séance 1 - Prise en main de l'IDE RStudio (1h)

## Objectif de l'atelier
- installer la version desktop de RStudio
- utiliser les principales fonctionnalités des panneaux de RStudio (édition, console, navigateurs)
- créer un projet RStudio
- savoir où et comment sauveguarder les historiques, les objets R

## Support de l'atelier

![Getting started with RStudio](https://learning.oreilly.com/library/cover/9781449314798/250w/)

## Qu'est ce que R ?

- un environnement logiciel open-source pour les calculs scientifiques et les graphiques.
- disponibles pour Windows, Mac OS X et plusieurs plateformes UNIX (incluant Linux) sous forme de binaires (compilés)
- Robert Gentleman and Ross Ihaka et la R’s core development team
- un langage de programmation (de script) interprété + add-on package
- the Comprehensive R Archive Network (CRAN) http://cran.r-project.org

## Pourquoi utiliser l'IDE RStudio ?

- IDE (Integrated Development Environnment)
- facilite l'écriture le développement de programme et de fonctions dans un environnement intégré
- projet open-source, multi-plateformes (Windows, Mac Os X, UNIX)
- mode standalone (Desktop Rstudio) ou serveur (à travers un naviguateur web, RStudio server)
- organisé sous forme de 4 panneaux (éditeur de code source, console+terminal, navigateur d'objets/historiques, navigateurs de fichiers/graphiques/packages/aide)
- plus convivial que la console R pour débuter, plus facile à apprendre que Emacs, plus facile à installer que Eclipse ...
- développement actif

## Installation de la version Desktop de RStudio

RStudio nécessite l'installation d'une version récente de R (http://cran.r-project.org).

Vérifier si une version n'est pas déjà installée sur votre OS.
```bash
R
```

Puis installer RStudio depuis rstudio.com (https://rstudio.com/products/rstudio/download/#download).

> ### Astuce
> Utiliser la variable d'environnement `RSTUDIO_WHICH_R` afin de  pointer sur une version de R donnée.
```bash
export RSTUDIO_WHICH_R=/usr/local/bin/R
```

## Premiers pas avec RStudio

Une fois installée lancer RStudio.

### Notion d'Espace de travail (Workspace)
Au lancement de RStudio, R est lancé: 

> - Le programme R est lancé dans le répertoire courant (**working directory** - wd)
> - Si présentes, les commandes dans le fichier **.Rprofile** sont executées
> - Si présentes les données dans le fichier **.Rdata** sont chargées
> - En quitant (à l'aide de la commande `quit()`), l'utilisateur peut sauvegarder son espace de travail en répondant "yes" à la question "Save workspace image ?" (les données stockées dans les **objets R** seront écrites dans le **.RData**, les commandes dans le fichier **.Rhistory**)
> - Il y a la possibilité d'utiliser la commande `save.image()` ou `save()` en cours de session pour sauveguarder respectivement tout ou une partie des objets de la session dans un fichier au foramt **.RData**. Il y a la possibilité de recharger ce fichier à l'aide de la fonction `load()`

### Création de Projets sous RStudio

RStudio peut créer un nouveau projet (**"New  Directory"**) ou importer un projet existant depuis un répertoire/dossier (**"Existing Directory"**) ou depuis un gestionnaire de version (**"Version Control"**) (git, svn).
Les nouveaux projets sont de plusieurs types (Analyse : **"New Project"**, Développement de packages: **"R Package"** ou d'application Shiny **"Shiny Web Application"**)

- Possibilité de créer un dépôt **git** associé ("Create a git repository")
- Possibilité d'utiliser un gestionnaire de package **Packrat** ("Use packrat with this project") http://rstudio.github.io/packrat/rstudio.html

### Préférences de RStudio

En cliquant sur l'onglet RStudio>preferences nous avons accès aux options paramétrables de RStudio.

## Quelques cours en ligne utiles 

https://openclassrooms.com/fr/courses/4525256-initiez-vous-au-langage-r-pour-analyser-vos-donnees/

http://swcarpentry.github.io/r-novice-gapminder/01-rstudio-intro/index.html

https://r.developpez.com/tutoriels/introduction-r-et-rstudio/

# Séance 1-bis - Utiliser RStudio server sur le cloud (1h)

# Séance 2 - Initiation à R sous RStudio (1h)

Le **package base** de R est constitué d'un ensemble de fonctions et de données installés par défaut.

Nous allons utiliser le jeux de données `iris` pour illustrer les différentes fonctionalités de base de R.
https://fr.wikipedia.org/wiki/Iris_de_Fisher

<img src="https://upload.wikimedia.org/wikipedia/commons/thumb/5/56/Kosaciec_szczecinkowaty_Iris_setosa.jpg/440px-Kosaciec_szczecinkowaty_Iris_setosa.jpg" width="100px"> <i>Iris setosa</i><br>
<img src="https://upload.wikimedia.org/wikipedia/commons/thumb/4/41/Iris_versicolor_3.jpg/440px-Iris_versicolor_3.jpg" width="100px"> <i>Iris versicolor</i><br>
<img src="https://upload.wikimedia.org/wikipedia/commons/thumb/9/9f/Iris_virginica.jpg/440px-Iris_virginica.jpg" width="100px"> <i>Iris virginica</i><br>

Nous allons pour se faire utiliser la fonction `data()`. 
> les fonctions en R sont toujours écrites de la manière suivante: nom_de_ma_fonction(liste de paramètres).

Pour avoir plus d'information faire précéder le nom de la fonction à l'aide de la commande `?`

```R
?data
#liste tous le datasets présents dans le package de base
data()
#charge le dataset "iris"
data(iris)
ls()
```

La fonction `ls()` permet de lister le contenu de l'espace de travail en terme d'objets R disponibles.
La fonction `class()` détermine la classe de l'objet passé en paramètre.
La fonction `names()` retourne dans un objet de classe vecteur le nom des différentes colonnes du dataframe passé en paramètre.

```R
class(iris)
dim(class)
names(iris)
class(iris$Sepal.Length)
```
## Premières statistiques et graphiques descriptifs

La fonction générique `summary()` donne un résumé de l'objet passé en paramètre. En ce qui concerne l'objet celà donne les valeures Min/Max,la médianne, la moyenne ainsi que les valeurs des premiers et troisième quartile

```R
summary(iris)
```

La fonction graphique `boxplot()` représente ces valeures graphiquement sous forme d'une boite à moustaches. Les **paramètre** `varwidth` donne une largeure variable en fonction dun ombre d'observation, `notch` (entaille) donne un intervalle de confiance à 95% autoir de la mediane, `outline` donne les valeures extrème en dehors des limites fiwée par la boite à moustache.

```R
boxplot(iris[1:4],varwidth = TRUE, notch = TRUE, outline = TRUE)
```

La fonction graphique `pairs()` donne un représentation sous forme d'une matrice de graphique de type scatterplot (plot de deux variables).

```R
pairs(iris[1:4],col=c("red","blue","green")[iris$Species])
```


## data.frame, vector, list, factor, matrix

Le langage R utilise des objets pour manipuler les données qui peuvent être de plusieurs classes.

- l'objet de classe `data.frame` permet de créer une liste de vecteur de

## Références de la formation
https://pbil.univ-lyon1.fr/R/pdf/bs01.pdf
https://rpubs.com/moeransm/intro-iris
https://github.com/hbctraining/Intro-to-R/blob/master/schedules/1.5-day.md
http://adv-r.had.co.nz/

## Apprendre R avec swirl

```R
> install.packages("swirl")
> library(swirl)
> swirl()
```

## Pour aller plus loin 
R For Data Science: https://r4ds.had.co.nz/index.html

## Prochains thèmes
Initiation à Bioconductor
Initiation à tidyverse
Initiation à RPostgreSQL
Initiation à Rmarkdown (https://rmarkdown.rstudio.com/)
Initiation à R shiny
...