-
Notifications
You must be signed in to change notification settings - Fork 57
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* premiers tests homepage * cards 2 * ajoute cartes * new cards * rm pdf test * improve navigation * prepare des cards * Retour du système de briques avec ojs * update * test box * box recommandation * recommandation box * update
- Loading branch information
1 parent
bfec792
commit 996a399
Showing
56 changed files
with
5,778 additions
and
5,140 deletions.
There are no files selected for viewing
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,6 +1,8 @@ | ||
# Utiliser des _packages_ `R` {#utiliser-packages} | ||
|
||
::: {.callout-recommandation .icon} | ||
::: {.callout-important} | ||
## Tâche concernée et recommandation | ||
|
||
- Avant d'installer un _package_, il est indispensable de déterminer précisément quel est le _package_ dont vous avez besoin. Pour cela, vous pouvez consulter les autres fiches de la documentation `utilitR`, et la fiche [Comment choisir un _package_ ?]. | ||
- Il est recommandé d'utiliser la fonction `install.packages` pour installer et mettre à jour les _packages_, sans modifier les arguments `repos`, `lib`, `type` et `dependencies`. L'usage de la fonction `update.packages` est destiné à des usages avancés. | ||
- Il est recommandé d'utiliser la fonction `library` pour charger les _packages_ sans modifier l'argument `lib.loc`. | ||
|
@@ -27,7 +29,7 @@ Les _packages_ `R` sont disponibles sur des sites spécialisés appelés dépôt | |
|
||
Les _packages_ peuvent également être mis à disposition par leurs auteurs sur les forges logicielles (telles que Github et Gitlab), mais il s'agit alors la plupart du temps de versions expérimentales dont l'usage est principalement destiné aux utilisateurs avancés de `R`. | ||
|
||
::: {.callout-remarque .icon} | ||
::: {.callout-note} | ||
Le CRAN dispose de plusieurs copies, appelées _miroirs_, dont la plupart sont hébergés sur des [serveurs d'universités ou d'établissements de recherche](https://cran.r-project.org/mirrors.html). Télécharger un _package_ sur un miroir ou un autre est strictement équivalent. L'intérêt de choisir un miroir proche de sa localisation permet simplement de gagner en vitesse et de réduire les flux sur le réseau. | ||
::: | ||
|
||
|
@@ -122,7 +124,7 @@ permet ainsi de récupérer la version de développement d'un _package_ | |
un _package_ tel qu'il était à un moment donné, il est également possible de | ||
faire suivre le nom du dépôt par une référence à un `r with_def("commit")`, à un _tag_ (une version) ou à une `r with_def("branche")`. Voici un exemple avec un _tag_ : `remotes::install_gitlab("py_b/[email protected]")`. Voici un exemple avec un commit : `remotes::install_github("InseeFrLab/doremifasolData@a9df2d3d0e372")`. | ||
|
||
::: {.callout-remarque .icon} | ||
::: {.callout-note} | ||
Lorsque vous installez un _package_ depuis une forge logicielle, `R` crée automatiquement une archive temporaire (un fichier `.tar.gz`), puis installe le _package_ à partir de celle-ci. Si vous travaillez dans un environnement Windows, il est nécessaire que `Rtools` soit installé sur votre poste pour que `R` puisse construire l'archive. | ||
|
||
`Rtools` est un logiciel (pas un _package_) qui contient un certain nombre d'outils pour construire des _packages_ `R` sous Windows. `Rtools` n'est en revanche pas nécessaire sur les systèmes Mac ou Linux. Vous pouvez vérifier si `Rtools` est installé en exécutant la fonction `pkgbuild::has_rtools()`. Celle-ci renvoie `TRUE` si `Rtools` est installé, `FALSE` sinon. Si `Rtools` n'est pas installé, vous pouvez l'installer facilement en le téléchargeant sur internet. | ||
|
@@ -166,7 +168,8 @@ Chacune de ces manipulations effectuées par l'intermédiaire de l'interface gra | |
Lors de l'ouverture d'un script, `RStudio` tente aussi de détecter automatiquement si les _packages_ utilisés dans celui-ci sont installés. Dans le cas contraire, il affiche un bandeau en haut du script proposant d'installer les _packages_ manquants : | ||
`▲ _package_ --- required but is not installed. Install Don't show again` | ||
|
||
::: {.callout-insee .icon} | ||
::: {.callout-warning} | ||
## Spécificité Insee | ||
Il ne faut pas essayer d'installer des _packages_ en cliquant sur le bouton <kbd> Install </kbd> du bandeau si vous travaillez dans AUS. En effet, si vous cliquez sur ce bouton, RStudio essaie de télécharger le _package_ depuis le CRAN (qui n'est pas accessible depuis AUS). Il faut utiliser la fonction `install.packages` à la place. | ||
::: | ||
|
||
|
@@ -180,7 +183,7 @@ library(ggplot2) | |
|
||
Par défaut, la fonction `library` cherche le _package_ dans la librairie d'installation des _packages_ (voir le paragraphe \@ref(libraries)). `R` renvoie une erreur s'il ne trouve pas le _package_ considéré dans la librairie. Il est possible de modifier la librairie dans laquelle la fonction `library` cherche les _packages_ grâce à l'argument `lib.loc`, mais vous n'avez normalement pas besoin de le faire dans le cadre d'un usage standard de `R`. | ||
|
||
::: {.callout-conseil .icon} | ||
::: {.callout-tip} | ||
Il est indispensable de rassembler les instructions de chargement de _package_ au début des programmes `R`, car cela permet à un utilisateur qui ne connaît pas les programmes de repérer facilement les _packages_ utilisés. | ||
::: | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.