Différences entre les versions de « Knitr »

(Page créée avec « Catégorie:Logiciels <!-- Knitr knitr R Statistiques statistiques LaTeX latex Sweave sweave --> thumb|Knitr est une librairie du logiciel [[R.]] ... »)
 
Ligne 3 : Ligne 3 :
 
[[Image:R_Logo.png|thumb|Knitr est une librairie du logiciel [[R]].]]
 
[[Image:R_Logo.png|thumb|Knitr est une librairie du logiciel [[R]].]]
  
La librairie [http://yihui.name/knitr/ knitr] appartient au logiciel [[R]] et sert d'intermédiaire entre un document [[LaTeX]] et du code R. Grâce à cette librairie, il est possible d'écrire des fichiers qui contiennent à la fois du code LaTeX et du code R. Un tel fichier générera automatiquement un document avec ses résultats, ses tableaux, ses graphiques, etc. pour produire un document. Il s'agit d'un exemple de [http://fr.wikipedia.org/wiki/Programmation_lettr%C3%A9e programmation lettrée].
+
La librairie [http://yihui.name/knitr/ knitr] appartient au logiciel [[R]] et sert d'intermédiaire entre un document [[LaTeX]] et du code R. Grâce à cette librairie, il est possible d'écrire des fichiers contenant les deux langages. Un tel fichier générera automatiquement un document avec ses résultats, ses tableaux, ses graphiques, etc. Il s'agit d'un exemple de [http://fr.wikipedia.org/wiki/Programmation_lettr%C3%A9e programmation lettrée].
  
Knitr est une librairie offrant plus de fonctionnalités que la fonction [http://www.stat.uni-muenchen.de/~leisch/Sweave/ Sweave] de R.
+
Knitr offre plus de fonctionnalités que la fonction [http://www.stat.uni-muenchen.de/~leisch/Sweave/ Sweave] de R.
  
 
__TOC__
 
__TOC__
  
== Fonctionnement ==
+
== Installation ==
  
L'idée est d'écrire un document LaTeX ordinaire, mais au lieu d'inclure des tableaux ou des graphiques préalablement générés, on écrit directement le code R qui les génère. De cette façon, les documents sont dynamiques et s'adaptent directement si l'on change les échantillons ou l'analyse. Un des avantages d'utiliser knitr est bien évidemment d'éviter d'avoir à retaper un document LaTeX en cas de changements ou d'erreur dans le code produisant l'analyse. Mais aussi, cela facilite la reproduction des résultats par d'autres utilisateurs.
+
La librairie knitr ne fait pas partie des librairies installées au Département. Par contre, il est possible de l'installer sur son propre compte DMS. Pour ce faire, il suffit d'entrer la commande suivantes dans le logiciel [[R]].
  
Évidemment, une syntaxe particulière est requise pour la rédaction du document et il faut exécuter le document source au moins deux fois&nbsp;: une fois avec R suivi d'au moins une fois avec LaTeX. Un [https://bitbucket.org/stat/knitr/downloads/knitr-manual.pdf manuel d'utilisation] explique en détail la syntaxe qu'il faut utiliser, mais voici brièvement quelques indications&nbsp;:
+
<pre>
 +
install.packages('knitr', dep=T)
 +
</pre>
  
* Le document est construit en fragment qui sont compopsés de texte ou de code.
+
Le logiciel affirmera qu'il ne possède pas les droits d'écriture dans le fichier central de R et vous demandera si vous désirez installer une version locale. Il faut alors répondre oui et suivre les indications pour terminer l'installation.
* Les fragments de texte commencent par un <code>@</code> suivis d'un saut de ligne. Par défaut, le prermier fragment est toujours un fragment de texte.
 
* Les fragments de code commencent par <code>&lt;&lt;''paramètres''&gt;&gt;=</code> suivis d'un saut de ligne. Les [http://yihui.name/knitr/options#chunk_options paramètres] déterminent les options d'affichage.
 
* Le fichier source porte généralement l'extension ''.Rnw''.
 
  
Une fois que le fichier source est écrit, il suffit d'appeler la fonction <code>knit</code> de la librairie avec le nom du fichier en argument.
+
== Fonctionnement ==
  
== Installation ==
+
L'idée est d'écrire un document LaTeX ordinaire, mais au lieu d'inclure des tableaux ou des graphiques préalablement générés, on écrit directement le code R qui les génère. De cette façon, les documents sont dynamiques et s'adaptent directement si l'on change les échantillons ou l'analyse.
  
La librairie knitr ne fait pas partie des librairies installées au Département. Par contre, il est possible de l'installer sur son propre compte DMS. Pour ce faire, il suffit d'entrer la commande suivantes dans le logiciel [[R]].
+
Un des avantages d'utiliser knitr est bien évidemment d'éviter d'avoir à retaper un document LaTeX en cas de changements ou d'erreur dans le code produisant l'analyse. Mais aussi, cela facilite la reproduction des résultats par d'autres utilisateurs. C'est donc un bon avantage pour les publications scientifiques.
  
<pre>
+
Évidemment, une syntaxe particulière est requise pour la rédaction du document et il faut exécuter le document source au moins deux fois&nbsp;: une fois avec R suivi d'au moins une fois avec LaTeX. Un [https://bitbucket.org/stat/knitr/downloads/knitr-manual.pdf manuel d'utilisation] explique en détail la syntaxe qu'il faut utiliser, mais voici brièvement quelques indications&nbsp;:
install.packages('knitr', dep=T)
 
</pre>
 
  
Le logiciel affirmera qu'il ne possède pas les droits d'écriture dans le fichier central et vous demandera si vous désirez installer une version locale. Il faut alors répondre oui et suivre les autres indications.
+
* Le document est construit en fragments qui sont composés de texte ou de code.
 +
* Les fragments de texte commencent par un <code>@</code> suivi d'un saut de ligne. Par défaut, le prermier fragment est toujours un fragment de texte.
 +
* Les fragments de code commencent par <code>&lt;&lt;''paramètres''&gt;&gt;=</code> suivi d'un saut de ligne. Les [http://yihui.name/knitr/options#chunk_options paramètres] déterminent les options d'affichage.
 +
* Le fichier source porte généralement l'extension ''.Rnw''.
  
== Exemple ==
+
Une [http://yihui.name/knitr/demos liste d'exemples] est disponible en ligne. Pour compiler un exemple, il faut d'abord avoir installé la librairie sur son compte. Dans une session de R, il faut ensuite importer la libraire puis appeler la fonction <code>knit</code> avec le fichier en argument&nbsp;:
  
Par exemple,
 
 
<pre>
 
<pre>
 +
require(knitr)
 
knit("fichier.Rnw")
 
knit("fichier.Rnw")
 
</pre>
 
</pre>
Ceci créera un fichier ''.tex'' du même nom. Il suffira finalement de compiler ce dernier fichier à l'aide de [[LaTeX]] de la façon habituelle.
+
 
 +
Cette dernière ligne produira un fichier ''.tex'' qu'il suffira de compiler à l'aide de [[LaTeX]] selon la procédure habituelle.
  
 
== Voir aussi ==
 
== Voir aussi ==

Version du 8 octobre 2013 à 14:14

Knitr est une librairie du logiciel R.

La librairie knitr appartient au logiciel R et sert d'intermédiaire entre un document LaTeX et du code R. Grâce à cette librairie, il est possible d'écrire des fichiers contenant les deux langages. Un tel fichier générera automatiquement un document avec ses résultats, ses tableaux, ses graphiques, etc. Il s'agit d'un exemple de programmation lettrée.

Knitr offre plus de fonctionnalités que la fonction Sweave de R.

Installation

La librairie knitr ne fait pas partie des librairies installées au Département. Par contre, il est possible de l'installer sur son propre compte DMS. Pour ce faire, il suffit d'entrer la commande suivantes dans le logiciel R.

install.packages('knitr', dep=T)

Le logiciel affirmera qu'il ne possède pas les droits d'écriture dans le fichier central de R et vous demandera si vous désirez installer une version locale. Il faut alors répondre oui et suivre les indications pour terminer l'installation.

Fonctionnement

L'idée est d'écrire un document LaTeX ordinaire, mais au lieu d'inclure des tableaux ou des graphiques préalablement générés, on écrit directement le code R qui les génère. De cette façon, les documents sont dynamiques et s'adaptent directement si l'on change les échantillons ou l'analyse.

Un des avantages d'utiliser knitr est bien évidemment d'éviter d'avoir à retaper un document LaTeX en cas de changements ou d'erreur dans le code produisant l'analyse. Mais aussi, cela facilite la reproduction des résultats par d'autres utilisateurs. C'est donc un bon avantage pour les publications scientifiques.

Évidemment, une syntaxe particulière est requise pour la rédaction du document et il faut exécuter le document source au moins deux fois : une fois avec R suivi d'au moins une fois avec LaTeX. Un manuel d'utilisation explique en détail la syntaxe qu'il faut utiliser, mais voici brièvement quelques indications :

  • Le document est construit en fragments qui sont composés de texte ou de code.
  • Les fragments de texte commencent par un @ suivi d'un saut de ligne. Par défaut, le prermier fragment est toujours un fragment de texte.
  • Les fragments de code commencent par <<paramètres>>= suivi d'un saut de ligne. Les paramètres déterminent les options d'affichage.
  • Le fichier source porte généralement l'extension .Rnw.

Une liste d'exemples est disponible en ligne. Pour compiler un exemple, il faut d'abord avoir installé la librairie sur son compte. Dans une session de R, il faut ensuite importer la libraire puis appeler la fonction knit avec le fichier en argument :

require(knitr)
knit("fichier.Rnw")

Cette dernière ligne produira un fichier .tex qu'il suffira de compiler à l'aide de LaTeX selon la procédure habituelle.

Voir aussi

Articles connexes

Références


La dernière modification de cette page a été faite le 8 octobre 2013 à 14:14.