Chapitre 7. Maintenance des sessions
337
B- Cr´ eation d’un mini-package
• Les objets du package
7.1- Lancez R, puis changez le r´ epertoire courant pour vous placer sur le bureau de Windows au moyen de l’instruction setwd(choose.dir()).
7.2- Cr´ eez les deux fonctions et les deux jeux de donn´ ees suivants :
f <- function(x,y) x+y
g <- function(x,y) x-y
d <- data.frame(a=1,b=2)
e <- rnorm(1000)
• L’arborescence du package
7.3- Utilisez la fonction package.skeleton() pour cr´ eer l’arborescence de
votre package.
package.skeleton(name="PetitPkgR",list=c("f","g","d","e"))
Un dossier nomm´ e PetitPkgR est alors cr´ e´ e sur le bureau. Celui-ci contient
trois dossiers (data, man et R) et deux fichiers (DESCRIPTION et Readand-delete-me).
Le dossier data contient les fichiers d.RData et e.RData, qui contiennent
(dans un format binaire) les jeux de donn´ ees d et e pr´ ec´ edemment import´ es depuis la console de R.
Le dossier R contient les fichiers f.R et g.R, qui contiennent le code source
des fonctions f et g d´ efinies pr´ ec´ edemment.
Le dossier man contient les fichiers d’aide pour tous les objets inclus dans
le package.
7.4- Modifiez imp´ erativement ces fichiers d’aide (fichiers d’extension .Rd)
mˆ eme s’ils sont pr´ eremplis, en vous aidant de la description du fichier
d’aide sur la fonction mean() fourni dans le chapitre 4. Les champs `
a renseigner sont indiqu´ es dans tous les fichiers d’aide par des phrases d´ ebutant
par le signe %%. Remplacez ces lignes (y compris le signe %%) par les
informations appropri´ ees. Il ne faut pas modifier les phrases commen¸ cant
par un simple signe %. En outre, pour les champs de la forme keyword ∼
kwd1, il faut absolument remplacer ∼ kwd1 par l’un des keywords (mots
clefs) r´ eserv´ es du langage R dont la liste peut ˆ etre obtenue au moyen de
l’instruction file.show(file.path(R.home("doc"), "KEYWORDS")).
7.5- Vous devez ´ egalement modifier le fichier DESCRIPTION pour renseigner
les champs le n´ ecessitant. Il est par exemple tr` es important de renseigner une adresse email valide.
337
B- Cr´ eation d’un mini-package
• Les objets du package
7.1- Lancez R, puis changez le r´ epertoire courant pour vous placer sur le bureau de Windows au moyen de l’instruction setwd(choose.dir()).
7.2- Cr´ eez les deux fonctions et les deux jeux de donn´ ees suivants :
f <- function(x,y) x+y
g <- function(x,y) x-y
d <- data.frame(a=1,b=2)
e <- rnorm(1000)
• L’arborescence du package
7.3- Utilisez la fonction package.skeleton() pour cr´ eer l’arborescence de
votre package.
package.skeleton(name="PetitPkgR",list=c("f","g","d","e"))
Un dossier nomm´ e PetitPkgR est alors cr´ e´ e sur le bureau. Celui-ci contient
trois dossiers (data, man et R) et deux fichiers (DESCRIPTION et Readand-delete-me).
Le dossier data contient les fichiers d.RData et e.RData, qui contiennent
(dans un format binaire) les jeux de donn´ ees d et e pr´ ec´ edemment import´ es depuis la console de R.
Le dossier R contient les fichiers f.R et g.R, qui contiennent le code source
des fonctions f et g d´ efinies pr´ ec´ edemment.
Le dossier man contient les fichiers d’aide pour tous les objets inclus dans
le package.
7.4- Modifiez imp´ erativement ces fichiers d’aide (fichiers d’extension .Rd)
mˆ eme s’ils sont pr´ eremplis, en vous aidant de la description du fichier
d’aide sur la fonction mean() fourni dans le chapitre 4. Les champs `
a renseigner sont indiqu´ es dans tous les fichiers d’aide par des phrases d´ ebutant
par le signe %%. Remplacez ces lignes (y compris le signe %%) par les
informations appropri´ ees. Il ne faut pas modifier les phrases commen¸ cant
par un simple signe %. En outre, pour les champs de la forme keyword ∼
kwd1, il faut absolument remplacer ∼ kwd1 par l’un des keywords (mots
clefs) r´ eserv´ es du langage R dont la liste peut ˆ etre obtenue au moyen de
l’instruction file.show(file.path(R.home("doc"), "KEYWORDS")).
7.5- Vous devez ´ egalement modifier le fichier DESCRIPTION pour renseigner
les champs le n´ ecessitant. Il est par exemple tr` es important de renseigner une adresse email valide.