presentation r markdown
DESCRIPTION
Package R MarkdownTRANSCRIPT
![Page 1: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/1.jpg)
Package R Markdown: Un outil pour générer des pages html avec R Studio
Sophie LAMARRE – Plateforme GeT-Biopuces à Toulouse
Email: [email protected]
Réunion du Groupe Utilisateurs de R
« FLtauR »
6 Novembre 2013
![Page 2: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/2.jpg)
1. Qu’est-ce que R Markdown?
2. Cas d’utilisations
3. Comment ca marche?
4. Plus de détails
Plan
4. Plus de détails
5. Vers une mise en page personnalisée
6. Pour aller plus loin
7. Conclusion
8. Annexes
2
![Page 3: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/3.jpg)
• C’est un package de R qui combiné à R Studio, permet de créer de manière simplifiée des pages web.
• Sur la page web on peut mettre:
1. Qu’est ce que R Markdown?
• Sur la page web on peut mettre:– du code R
– le résultat de l‘exécution
– des graphiques
– des images
– des formules
– …
3
![Page 4: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/4.jpg)
• Pour créer un cours que l’on veut publier en
ligne (avec Rpubs)
• Pour réaliser un compte rendu avec affichage
des résultats (issu des commandes tapées
2. Cas d’utilisations
des résultats (issu des commandes tapées
dans R), que l’on souhaite communiquer à
d’autres personnes (sans avoir à s’initier au
Latex pour écrire des rapports avec Sweave)
• …
4
![Page 5: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/5.jpg)
• Le package « markdown » fonctionne avec le package « knitr » (à télécharger sur le CRAN
lors de la première utilisation)
• Ce dernier permet d’inclure et d’exécuter le
3. Comment ca marche?
• Ce dernier permet d’inclure et d’exécuter le code R qui génère des tableaux et/ou des graphiques (au lieu d’insérer les tableaux et/ou les graphiques exécutés préalablement)
-> reproductibilité des documents
5
![Page 6: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/6.jpg)
• On ouvre R Studio
• On créé un fichier R Markdown
3. Comment ca marche?
6
![Page 7: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/7.jpg)
• On enregistre le fichier que l’on vient de créer (de toute façon, R Studio demandera à ce qu’il porte un nom
pour qu’il puisse transformer le fichier en un format .html).
3. Comment ca marche?
On appuie sur « Knit HTML »
7
![Page 8: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/8.jpg)
• On obtient notre page html générée
3. Comment ca marche?
8
![Page 9: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/9.jpg)
• Dans notre dossier, on a:
– Un fichier .rmd: contenu de la page web
– Un fichier .md: contient le code R traduit (ex: résultats des
tableaux et des graphiques)
3. Comment ca marche?
Package Knitr:
Permet la
compilation du
code R
Package
markdown:
– Un fichier .html: page web créée
– Un dossier « figure »: contient les graphiques, images
créés
9
markdown:
Génère la
page web
![Page 10: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/10.jpg)
• Si on souhaite publier en ligne notre page:
3. Comment ca marche?
On clique sur « Publish »
10
Attention, la page sera publique
![Page 11: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/11.jpg)
• Une autre fonctionnalité intéressante Notebooks:
Créer une page web directement à partir du code R!
3. Comment ca marche?
11
On clique sur le dernier icône à droite
![Page 12: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/12.jpg)
3. Comment ca marche?
• Une autre fonctionnalité intéressante Notebooks:
Créer une page web directement à partir du code R!
12
![Page 13: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/13.jpg)
• Ajouter du code et voir le résultat:
4. Plus de détails
Le code sur le fichier .Rmd
13
Le résultat de la page Html
![Page 14: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/14.jpg)
• Affichage d’un graphique généré avec R:
4. Plus de détails
Le résultat de la page Html
14
Le code sur le fichier .Rmd
![Page 15: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/15.jpg)
• Insérer un tableau:
4. Plus de détails
Le code sur le fichier .Rmd
15
Le résultat de la page Html
![Page 16: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/16.jpg)
• Insérer une équation:
4. Plus de détails
Le code sur le fichier .Rmd
16
Le résultat de la page Html
![Page 17: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/17.jpg)
• Insérer une image:
4. Plus de détails
Le code sur le fichier .Rmd
17
Le résultat de la page Html
![Page 18: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/18.jpg)
• Insérer un lien vers une page Internet:
4. Plus de détails
Le code sur le fichier .Rmd
18
Le résultat de la page Html
![Page 19: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/19.jpg)
• Insérer une citation:
4. Plus de détails
Le code sur le fichier .Rmd
19
Le résultat de la page Html
![Page 20: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/20.jpg)
• Par défaut, la mise en page est un peu sommaire:
– Pas de couleurs
– Tableaux sans bordures
– Texte non souligné
– …
5. Vers une mise en page personnalisée
20
![Page 21: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/21.jpg)
• On peut grâce à la feuille de style CSS modifier cette mise en page.
La procédure à suivre est la suivante:
– copier la feuille de style CSS nommée “markdown.css” qui se trouve dans le
répertoire du package “Markdown” (endroit où tous les packages sont stockés)
– la renommer
– Modifier la feuille de style avec la mise en page que l’on souhaite (exemple:
couleurs aux titres, bordures aux tableaux …)
– la placer à l'endroit où on a stocké notre fichier .Rmd .
5. Vers une mise en page personnalisée
– la placer à l'endroit où on a stocké notre fichier .Rmd .
– Ensuite, dans notre fichier .Rmd, on écrit en haut: la ligne suivante entourée de
“<” et “>”:
link href=“my_custom.css” rel=“stylesheet”
21
![Page 22: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/22.jpg)
5. Vers une mise en page personnalisée
Sans mise en forme Avec mise en forme
22
![Page 23: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/23.jpg)
5. Vers une mise en page personnalisée
Sans mise en forme Avec mise en forme
23
![Page 24: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/24.jpg)
5. Vers une mise en page personnalisée
Sans mise en forme Avec mise en forme
24
![Page 25: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/25.jpg)
D’autres fonctionnalités existent et n’ont pas été montrées lors de cette séance:
• Réaliser des graphiques interactifs avec GoogleVis et les afficher sur la page
web créée
http://rpubs.com/gallery/googleVis
• Convertir la page web en format pdf avec Pandoc
6. Pour aller plus loin
• Convertir la page web en format pdf avec Pandoc
Sous Linux, une fois la page web créée:
- Ouvrir une console
- Se placer dans le répertoire où se trouve le fichier « .md »
- Taper: pandoc-s Nom_fichier.md –o Nom_fichier.pdf
Attention: la mise en page est altérée (tableaux déformés, couleurs non originales …).
Sinon, la méthode basique, imprimer dans fichier pdf marche bien aussi!
• Et bien d’autres encore!
25
![Page 26: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/26.jpg)
7. Conclusion
Package intéressant qui permet de créer des
rapports reproductibles sous forme de pages
web, facilement sans avoir à connaître
26
web, facilement sans avoir à connaître
Le langage Latex ni Html.
![Page 27: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/27.jpg)
8. AnnexesLe code .Rmd utilisé dans cette présentation
27
![Page 28: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/28.jpg)
8. AnnexesLe code .Rmd utilisé dans cette présentation
28
![Page 29: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/29.jpg)
8. AnnexesLe code .Rmd utilisé dans cette présentation
29
![Page 30: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/30.jpg)
8. AnnexesLe code .css utilisé dans cette présentation
30
![Page 31: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/31.jpg)
8. AnnexesLe code .css utilisé dans cette présentation
31
![Page 32: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/32.jpg)
8. AnnexesLe code .css utilisé dans cette présentation
32
![Page 33: Presentation r markdown](https://reader036.vdocuments.net/reader036/viewer/2022081720/558b0be0d8b42afe758b4774/html5/thumbnails/33.jpg)
8. AnnexesLe code .css utilisé dans cette présentation
33