Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 70 additions & 8 deletions learners/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@
réalisées au début de l'épidémie servent généralement de données d'entrée pour
les tâches requises au cours des étapes suivantes.

![Aperçu des thèmes abordés dans le cadre de ce tutoriel](https://epiverse-trace.github.io/task_pipeline-minimal.svg)

Check warning on line 37 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

[image missing alt-text]: https://epiverse-trace.github.io/task_pipeline-minimal.svg

Nous avons conçu un site Web pour chaque tâche de ce tutoriel. Chaque site Web
est composé d'un ensemble d'épisodes couvrant différents sujets.
Expand Down Expand Up @@ -67,7 +67,7 @@
devraient combler les lacunes notées dans ces pipelines d'analyse
épidémiologiques qui sont conçus en vue d'apporter des réponses aux épidémies.

![L'unité fondamentale de partage de code dans **R** est le **package**. Un package regroupe du code, des données, de la documentation et des tests et est facile à partager avec d'autres ([Wickham et Bryan, 2023](https://r-pkgs.org/introduction.html))](../../../episodes/fig/pkgs-hexlogos-2.png)

Check warning on line 70 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

[missing file]: [L'unité fondamentale de partage de code dans R est le package . Un package regroupe du code, des données, de la documentation et des tests et est facile à partager avec d'autres ( Wickham et Bryan, 2023 )](../../../episodes/fig/pkgs-hexlogos-2.png) [image missing alt-text]: ../../../episodes/fig/pkgs-hexlogos-2.png

:::::::::::::::::::::::::::: prereq

Expand Down Expand Up @@ -123,12 +123,10 @@
- **Pour mettre à jour R** téléchargez et installez la dernière version à partir
du [site web du projet R](https://cran.rstudio.com/) pour votre système
d'exploitation.

- Après l'installation d'une nouvelle version, vous devrez réinstaller tous vos librairies avec la nouvelle version.

- Après l'installation d'une nouvelle version, vous devrez réinstaller tous vos
librairies avec la nouvelle version.

- Pour Windows, la librairie `{installr}` permet de mettre à jour votre version
de R et migrer votre bibliothèque de librairies.
- Pour Windows, la librairie `{installr}` permet de mettre à jour votre version de R et migrer votre bibliothèque de librairies.

- **Pour mettre à jour RStudio** ouvrez RStudio et cliquez sur
`Help > Check for Updates`. Si une nouvelle version est disponible, suivez les
Expand All @@ -145,7 +143,71 @@

:::::::::::::::::::::::::::::

### 2. Installez les librairies R requises
### 2. Vérifier et installer les outils de compilation

Certains paquets nécessitent un ensemble d'outils complémentaires pour être compilés.
Ouvrez RStudio et **copiez-collez** le bloc de code suivant dans la
[fenêtre de console](https://docs.posit.co/ide/user/ide/guide/code/console.html),
puis appuyez sur <kbd>Entrée</kbd> (Windows et Linux) ou <kbd>Retour</kbd> (MacOS) pour exécuter la commande :

```r
if(!require(« pkgbuild »)) install.packages(« pkgbuild »)
pkgbuild::check_build_tools(debug = TRUE)
```

Nous attendons un message similaire à celui ci-dessous :

```output
Your system is ready to build packages!
```

Si les outils de compilation ne sont pas disponibles, cela déclenchera une installation automatique.

1. Exécutez la commande dans la console.
2. Ne l'interrompez pas, attendez que R affiche le message de confirmation.
3. Une fois cela fait, redémarrez votre session R (ou redémarrez simplement RStudio) pour vous assurer que les modifications prennent effet.

Si l'installation automatique **ne fonctionne pas**, vous pouvez les installer manuellement en fonction de votre système d'exploitation.

::::::::::::::::::::::::::::: onglet

Check warning on line 172 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

[unknown div] onglet

### Windows

Les utilisateurs Windows auront besoin d'une installation fonctionnelle de `Rtools` afin de compiler le paquet à partir du code source.
`Rtools` n'est pas un paquet R, mais un logiciel que vous devez télécharger et installer.
Nous vous suggérons de suivre les étapes suivantes :

- **Installez `Rtools`**. Téléchargez le programme d'installation de `Rtools` à partir de <https://cran.r-project.org/bin/windows/Rtools/>. Installez-le en conservant les sélections par défaut.
- Fermez et rouvrez RStudio afin qu'il puisse reconnaître la nouvelle installation.

### Mac

Les utilisateurs Mac doivent suivre deux étapes supplémentaires, comme indiqué dans ce [guide de configuration de la chaîne d'outils C pour Mac](https://github.com/stan-dev/rstan/wiki/Configuring-C---Toolchain-for-Mac) :

- Installez et utilisez [`macrtools`](https://mac.thecoatlessprofessor.com/macrtools/) pour configurer la chaîne d'outils C++
- Activez certaines optimisations du compilateur.

### Linux

Les utilisateurs Linux doivent suivre des instructions spécifiques à leur distribution. Vous les trouverez dans ce [guide de configuration de la chaîne d'outils C pour Linux](https://github.com/stan-dev/rstan/wiki/Configuring-C-Toolchain-for-Linux).

:::::::::::::::::::::::::::::

::::::::::::: callout

### Vérification de l'environnement

Cette étape nécessite des privilèges d'administrateur pour installer le logiciel.

Si vous ne disposez pas des droits d'administrateur dans votre environnement actuel :

- Essayez d'exécuter le tutoriel sur votre **ordinateur personnel** auquel vous avez un accès complet.
- Utilisez un **environnement de développement préconfiguré** (par exemple, [Posit Cloud](https://posit.cloud/)).
- Demandez à votre **administrateur système** d'installer les logiciels requis pour vous.

:::::::::::::

### 3. Installez les librairies R requises

Ouvrez RStudio et **copiez et collez** le morceau de code suivant dans la
[fenêtre de la console](https://docs.posit.co/ide/user/ide/guide/code/console.html)
Expand Down Expand Up @@ -243,7 +305,7 @@
remotes::install_github("epiverse-trace/tracetheme")
```

Si l'erreur persiste, [contactez-nous](#your-questions)!

Check warning on line 308 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

[missing anchor]: [contactez-nous](#your-questions)

:::::::::::::::::::::::::::

Expand Down Expand Up @@ -273,9 +335,9 @@
```

Si vous ne voyez PAS d'erreur comme `there is no package called '...'` vous êtes
prêt à commencer ! Si c'est le cas, [contactez-nous](#your-questions)!

Check warning on line 338 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

[missing anchor]: [contactez-nous](#your-questions)

### 3. Créez un projet et un dossier RStudio
### 4. Créez un projet et un dossier RStudio

Nous vous suggérons d'utiliser les projets RStudio.

Expand Down Expand Up @@ -304,7 +366,7 @@

:::::::::::::::::::::::::::::::::

### 4. Créez un compte GitHub
### 5. Créez un compte GitHub

Nous pouvons utiliser [GitHub](https://github.com) comme plateforme de
collaboration pour communiquer sur les problèmes liés aux librairies et
Expand Down
Loading