R : Différence entre versions

Ligne 39 : Ligne 39 :
 
</pre>
 
</pre>
  
To install to another tree (e.g., your private one), use
+
Pour installer à un autre arbre (par exemple, votre bien-privé), utilisez
 
<pre>
 
<pre>
 
R CMD INSTALL -l lib /path/to/pkg_version.tar.gz
 
R CMD INSTALL -l lib /path/to/pkg_version.tar.gz
 
</pre>
 
</pre>
  
where <tt>lib</tt> gives the path to the library tree to install to.  
+
<tt>lib</tt> donne le chemin de l'arbre de bibliothèque pour l'installation.  
  
Even more conveniently, you can install and automatically update packages from within R if you have access to repositories such as CRAN. See the help page for available.packages() for more information.
+
Encore plus pratique, vous pouvez installer et mettre à jour automatiquement les paquets «packages» à partir de R si vous avez accès à des référentiels tels que le CRAN. Voir la page d'aide pour available.packages () pour plus d'informations.
  
You can use several library trees of add-on packages. The easiest way to tell R to use these is via the environment variable R_LIBS which should be a colon-separated list of directories at which R library trees are rooted. You do not have to specify the default tree in R_LIBS. E.g., to use a private tree in $HOME/lib/R and a public site-wide tree in /usr/local/lib/R-contrib, put
+
Vous pouvez utiliser des arbres de la bibliothèque de plusieurs paquets d'extension «add-on packages». La meilleure façon de dire à R d'utiliser les paquets d'extension «add-on packages» c'est via les variables d'environnement R_LIBS qui devrait être une liste séparées (par des deux points) des répertoires au cours de laquelle les arbres R de la bibliothèque sont enracinées. Vous n'avez pas à spécifier l'arbre de défaut dans R_LIBS. Par exemple, afin d'utiliser un arbre privé dans $ HOME/lib/R et un site public à l'échelle d'un arbre(public site-wide tree) dans /usr/local/lib/R-contrib, mettez
 
<pre>
 
<pre>
 
R_LIBS="$HOME/lib/R:/usr/local/lib/R-contrib"; export R_LIBS
 
R_LIBS="$HOME/lib/R:/usr/local/lib/R-contrib"; export R_LIBS
 
</pre>
 
</pre>
into your (Bourne) shell profile or even preferably, add the line
+
dans votre (Bourne) profil de shell ou même de préférence, ajoutez la ligne
 
<pre>
 
<pre>
 
R_LIBS="~/lib/R:/usr/local/lib/R-contrib"
 
R_LIBS="~/lib/R:/usr/local/lib/R-contrib"
 
</pre>
 
</pre>
your ~/.Renviron file. (Note that no export statement is needed or allowed in this file; see the on-line help for Startup for more information.)  
+
votre fichier ~/.Renviron . (Notez qu'aucune déclaration d'exportation est nécessaire ou autorisée dans ce fichier, consultez l'aide en ligne pour le démarrage «Startup» pour plus d'informations.)
  
=== How can add-on packages be used? ===
+
=== Comment peut-on utiliser les extensions «add-on packages»? ===
  
To find out which additional packages are available on your system, type
+
Afin de savoir quels paquets supplémentaires sont disponibles sur votre système, tapez
 
<pre>
 
<pre>
 
library()
 
library()
 
</pre>
 
</pre>
at the R prompt.
+
dans R prompt.
  
This produces something like
+
Ceci produit quelque chose comme
 
<pre>
 
<pre>
 
Packages in `/home/me/lib/R':               
 
Packages in `/home/me/lib/R':               
Ligne 97 : Ligne 97 :
 
utils        The R Utils Package       
 
utils        The R Utils Package       
 
</pre>
 
</pre>
You can “load” the installed package pkg by
+
Vous pouvez «loader/charger» le paquet installé pkg par
 
<pre>
 
<pre>
 
library(pkg)
 
library(pkg)
 
</pre>
 
</pre>
You can then find out which functions it provides by typing one of
+
Vous pouvez ensuite déterminer les fonctions qu'il offre en tapant l'une des
 
<pre>
 
<pre>
 
library(help = pkg)
 
library(help = pkg)
 
help(package = pkg)
 
help(package = pkg)
 
</pre>
 
</pre>
You can unload the loaded package pkg by
+
Vous pouvez «unloader/décharger» le paquet pkg «loadé/chargé» par
 
<pre>
 
<pre>
 
detach("package:pkg")
 
detach("package:pkg")
 
</pre>
 
</pre>
  
=== How can add-on packages be removed? ===
+
=== Comment peut-on supprimer/enlever les extensions «add-on packages»? ===
  
Use
+
utilisez
 
<pre>
 
<pre>
 
R CMD REMOVE pkg_1 ... pkg_n
 
R CMD REMOVE pkg_1 ... pkg_n
 
</pre>
 
</pre>
to remove the packages <tt>pkg_1</tt>, ..., <tt>pkg_n</tt> from the library tree rooted at the first directory given in R_LIBS if this is set and non-null, and from the default library otherwise. (Versions of R prior to 1.3.0 removed from the default library by default.)
+
pour supprimer les paquets  <tt>pkg_1</tt>, ..., <tt>pkg_n</tt> de la bibliothèque de l'arbre enracinés dans le premier répertoire donné dans R_LIBS si ce paramètre est réglé et non nulles, et à partir de la bibliothèque par défaut autrement. (Les versions de R avant 1.3.0 sont retirés de la bibliothèque par défaut, par défaut.)
  
To remove from library lib, do
+
Pour retirer de la bibliothèque lib, faites
 
<pre>
 
<pre>
 
R CMD REMOVE -l lib pkg_1 ... pkg_n
 
R CMD REMOVE -l lib pkg_1 ... pkg_n

Version du 3 janvier 2013 à 16:23


Le logo de R.

R est un langage de programmation et un environnement mathématique issu d'un projet GNU (similaire à S). R est employé pour le traitement de données et l'analyse statistique et dispose également de nombreuses fonctions graphiques.

Guide

Guide de R

Writing R Extensions

Démarrage de R

  • Pour lancer R en ligne de commandes, entrez
R

depuis une fenêtre de terminal.

  • Pour lancer R avec l'interface graphique, entrez plutôt ce qui suit dans un terminal de commandes:
xR

Lancer un programme en arrière-plan

Pour démarrer le programme prog.r en arrière-plan (en batch), entrez

R < prog.r --no-save &

dans un terminal de commandes. L'option --no-save spécifie à R de ne pas enregistrer l'espace de travail (workspace) lorsque le programme sera terminé.

Comment peut-on installer les extensions «add-on packages»?

Les paquetages d'extension «add-on packages» sur CRAN se forme de fichiers tar gzip nommés pkg_version.tar.gz, qui peuvent en fait être des «paquets» (bundles en anglais) contenant plus d'un paquet. Pourvu que tar et gzip sont disponibles sur votre système, tapez

R CMD INSTALL /path/to/pkg_version.tar.gz

Pour installer à un autre arbre (par exemple, votre bien-privé), utilisez

R CMD INSTALL -l lib /path/to/pkg_version.tar.gz

lib donne le chemin de l'arbre de bibliothèque pour l'installation.

Encore plus pratique, vous pouvez installer et mettre à jour automatiquement les paquets «packages» à partir de R si vous avez accès à des référentiels tels que le CRAN. Voir la page d'aide pour available.packages () pour plus d'informations.

Vous pouvez utiliser des arbres de la bibliothèque de plusieurs paquets d'extension «add-on packages». La meilleure façon de dire à R d'utiliser les paquets d'extension «add-on packages» c'est via les variables d'environnement R_LIBS qui devrait être une liste séparées (par des deux points) des répertoires au cours de laquelle les arbres R de la bibliothèque sont enracinées. Vous n'avez pas à spécifier l'arbre de défaut dans R_LIBS. Par exemple, afin d'utiliser un arbre privé dans $ HOME/lib/R et un site public à l'échelle d'un arbre(public site-wide tree) dans /usr/local/lib/R-contrib, mettez

R_LIBS="$HOME/lib/R:/usr/local/lib/R-contrib"; export R_LIBS

dans votre (Bourne) profil de shell ou même de préférence, ajoutez la ligne

R_LIBS="~/lib/R:/usr/local/lib/R-contrib"

votre fichier ~/.Renviron . (Notez qu'aucune déclaration d'exportation est nécessaire ou autorisée dans ce fichier, consultez l'aide en ligne pour le démarrage «Startup» pour plus d'informations.)

Comment peut-on utiliser les extensions «add-on packages»?

Afin de savoir quels paquets supplémentaires sont disponibles sur votre système, tapez

library()

dans R prompt.

Ceci produit quelque chose comme

Packages in `/home/me/lib/R':              
mystuff       My own R functions, nicely packaged but not documented
Packages in `/usr/local/lib/R/library':              
KernSmooth    Functions for kernel smoothing for Wand & Jones (1995)
MASS          Main Package of Venables and Ripley's MASS
base          The R Base package
boot          Bootstrap R (S-Plus) Functions (Canty)
class         Functions for Classification
cluster       Functions for clustering (by Rousseeuw et al.)
datasets      The R datasets Package
foreign       Read data stored by Minitab, S, SAS, SPSS, Stata, ...
grDevices     The R Graphics Devices and Support for Colours and Fonts
graphics      The R Graphics Package
grid          The Grid Graphics Package
lattice       Lattice Graphics
methods       Formal Methods and Classes
mgcv          GAMs with GCV smoothness estimation and GAMMs by REML/PQ
nlme          Linear and nonlinear mixed effects models
nnet          Feed-forward Neural Networks and Multinomial Log-Linear Models
rpart         Recursive partitioning
spatial       Functions for Kriging and Point Pattern Analysis
splines       Regression Spline Functions and Classes
stats         The R Stats Package
stats4        Statistical functions using S4 classes
survival      Survival analysis, including penalised likelihood
tcltk         Tcl/Tk Interface
tools         Tools for Package Development
utils         The R Utils Package      

Vous pouvez «loader/charger» le paquet installé pkg par

library(pkg)

Vous pouvez ensuite déterminer les fonctions qu'il offre en tapant l'une des

library(help = pkg)
help(package = pkg)

Vous pouvez «unloader/décharger» le paquet pkg «loadé/chargé» par

detach("package:pkg")

Comment peut-on supprimer/enlever les extensions «add-on packages»?

utilisez

R CMD REMOVE pkg_1 ... pkg_n

pour supprimer les paquets pkg_1, ..., pkg_n de la bibliothèque de l'arbre enracinés dans le premier répertoire donné dans R_LIBS si ce paramètre est réglé et non nulles, et à partir de la bibliothèque par défaut autrement. (Les versions de R avant 1.3.0 sont retirés de la bibliothèque par défaut, par défaut.)

Pour retirer de la bibliothèque lib, faites

R CMD REMOVE -l lib pkg_1 ... pkg_n

How can I clean up my workspace? To remove all objects in the currently active environment (typically .GlobalEnv), you can do

rm(list = ls(all = TRUE))

(Without all = TRUE, only the objects with names not starting with a `.' are removed.)

How do I produce PNG graphics in batch mode?

Under Unix, the png() device uses the X11 driver, which is a problem in batch mode or for remote operation. If you have Ghostscript you can use bitmap(), which produces a PostScript file then converts it to any bitmap format supported by Ghostscript. On some installations this produces ugly output, on others it is perfectly satisfactory. In theory one could also use Xvfb from X.Org, which is an X11 server that does not require a screen; and the GDD package from CRAN, which produces PNG, JPEG and GIF bitmaps without X11.

Batch Execution of R

Run R non-interactively with input from infile and send output (stdout/stderr) to another file. Usage

R CMD BATCH [options] infile [outfile]

Arguments

  • infile the name of a file with R code to be executed.
  • options a list of R command line options, e.g., for setting the amount of memory available and controlling the load/save process. If infile starts with a -, use -- as the final option. The default options are --restore --save --no-readline.
  • outfile the name of a file to which to write output. If not given, the name used is that of infile, with a possible ‘.R’ extension stripped, and ‘.Rout’ appended.

Fortran

Le logiciel R intègre l'utilisation de fichiers sources Fortran ( .f ). Ainsi, avec le fichier source Fortran "fichier.f" :

  • Compiler le fichier puis, dans un terminal, tapez: R CMD SHLIB fichier.f.
  • Ceci devrait créer dans votre répertoire deux fichiers: fichier.so et fichier.o.
  • Pour charger le fichier sous R, tapez (dans R): dyn.load("fichier.so").
  • Pour les débutants, un exemple fait par Jennifer Poulin: le fichier source transpose.f et le fichier de commandes sous R transpose.txt.
******7**10********20********30********40********50********60********7072
** Fichier "transpose.f" par Jennifer Poulin.
** Sous-routine calculant la transposée de A:
**
** A: MxN
** B = t(A): N:M
     SUBROUTINE TRANSPOSE(A,B,m,n)
     INTEGER i,j,m,n
     DOUBLE PRECISION A(m,n), B(n,m)
     DO i=1, n
       DO j=1, m
         B(i,j) = A(j,i)
       ENDDO
     ENDDO
     RETURN 
     END
** Exemple simple pour calculer la transposée d'une matrice sous R en utilisant le fichier source Fortran 
** "transpose.f" (par Jennifer Poulin):
y <- matrix(1:30, nrow=3)
dyn.load("transpose.so")
transpo2 <- function(A){
  n <- nrow(A)
  m <- ncol(A)
  B <- matrix(0,nrow=m,ncol=n)
  storage.mode(B) <- "double"
  resultat <- .Fortran("transpose",
    as.double(A),
    B=B,
    as.integer(n),
    as.integer(m))
  B <- resultat[["B"]]
  B
} 
> y
     [,1] [,2] [,3] [,4] [,5] [,6] [,7] [,8] [,9] [,10]
[1,]    1    4    7   10   13   16   19   22   25    28
[2,]    2    5    8   11   14   17   20   23   26    29
[3,]    3    6    9   12   15   18   21   24   27    30 

> transpo2(y)
      [,1] [,2] [,3]
 [1,]    1    2    3
 [2,]    4    5    6
 [3,]    7    8    9
 [4,]   10   11   12
 [5,]   13   14   15
 [6,]   16   17   18
 [7,]   19   20   21
 [8,]   22   23   24
 [9,]   25   26   27
[10,]   28   29   30

Voir aussi

Bibliographie

  • J. Adler, R in a Nutshell: A Desktop Quick Reference, O'Reilly, Sebastopol, CA 95472, 2010.

Articles connexes

Références externes