Skip to main content

Travail collaboratif avec R

Chapitre 1 Introduction : utiliser GIT avec R

Ce site web centralise les supports associés à une formation nationale développée à l’Insee et nommée Travail collaboratif avec R - Initiation. Celle-ci a vocation à durer environ 1,5 jour.

Une version plus synthétique, ayant vocation à durer une journée, est disponible dans une version provisoire sous un format de slides

1.1 Objectifs et environnement

Cette formation vise à présenter la manière dont un projet collaboratif peut être mené avec R et la manière dont RStudio facilite ce travail. L’objectif est d’apprendre les bases du contrôle de version qui s’appuie sur le logiciel Git et d’être autonome suite à cette formation. Accessoirement, cette formation donne quelques conseils pour mieux utiliser les projets RStudio qui sont devenus prédominants dans la communauté R.

Dans ce cadre, le parti pris est l’utilisation de RStudio. Il s’agit d’un choix peu suprenant puisque RStudio propose énormément de fonctionalités favorisant l’utilisation de R en conjonction avec Git.

Il est important d’utiliser des projets RStudio plutôt que des scripts individuels. Dans l’ensemble de cette formation, on va supposer qu’un projet R est mené via un projet RStudio. Plus d’information sur les RProjects sont disponibles dans la documentation utilitR.

Cette formation peut être suivie dans n’importe quel environnement disposant de RStudio et Git. Cependant, des précisions sont parfois nécessaires pour tenir compte de certaines spécificités de l’architecture interne de l’Insee (environnement AUS, forge Gitlab interne). Elles sont faites lorsque nécessaires mais réduites au minimum possible.

Cette formation ne nécessite pas de connaissances avancées en R, voire aucune car elle s’appuie uniquement sur les fonctionnalités de RStudio. À toute fin utile, la documentation utilitR constitue une ressource qu’il peut être intéressant de consulter en complément.

1.2 Au sujet de cette formation

Le code source est disponible sur Github ici. Le site web est hebergé par https://www.netlify.com, un fournisseur de nom de domaine favorisant l’open-source.

Le groupe de conception de ce support a lui-même suivi les recommandations de cette formation en proposant tous les supports en open-source: un dépôt Github, un joli arbre, des débats (sur l’ancien dépôt)…

Cette formation peut être complétée par certaines ressources de la documentation collaborative utilitR que nous recommandons de consulter régulièrement :

L’ancien site continue à proposer plus de chapitres mais n’est plus la version de référence. Cet ancien support sera petit à petit transformé en site web autosuffisants.

Contributeurs

Écriture du support (partie GIT) : Lino Galiana ; Mathias André ; Annie Moineau ; Romain Lesur ;

Relecteurs : Lino Galiana ; Mathias André ; Olivier Meslin ; Georges Pavlov; Romain Lesur ;

Mise en forme: Lino Galiana, Romain Lesur