Skip to content
Open
Show file tree
Hide file tree
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
3 changes: 3 additions & 0 deletions 01_R_Insee/Fiche-personnaliser-R.qmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# Personnaliser la configuration de `R` {#personnaliser}

```{r, echo=FALSE, results='asis'}
source(file.path(here::here(),"utils/derniere_modif.R"))
```
L'agent souhaite personnaliser sa configuration de `R`. Cette personnalisation consiste à définir certaines actions ou valeurs qui seront effectuées automatiquement à l'ouverture d'une session `R`.

::: {.callout-important}
Expand Down
4 changes: 4 additions & 0 deletions 01_R_Insee/Fiche_installer_packages.qmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Utiliser des _packages_ `R` {#utiliser-packages}

```{r, echo=FALSE, results='asis'}
source(file.path(here::here(),"utils/derniere_modif.R"))
```

::: {.callout-important}
## Tâche concernée et recommandation

Expand Down
4 changes: 4 additions & 0 deletions 01_R_Insee/Fiche_utiliser_Rstudio_AUSv3.qmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Utiliser RStudio sur l'environnement AUSv3 {#AUSv3}

```{r, echo=FALSE, results='asis'}
source(file.path(here::here(),"utils/derniere_modif.R"))
```

::: {.callout-important}
## Tâche concernée et recommandation

Expand Down
4 changes: 4 additions & 0 deletions 01_R_Insee/Fiche_utiliser_ressources.qmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Superviser sa session `R` {#superviser-ressources}

```{r, echo=FALSE, results='asis'}
source(file.path(here::here(),"utils/derniere_modif.R"))
```

::: {.callout-important}
## Tâche concernée et recommandation

Expand Down
4 changes: 4 additions & 0 deletions 01_R_Insee/Fiche_utiliser_utilitR.qmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Comment utiliser la documentation `utilitR` {#presentation-utilitr}

```{r, echo=FALSE, results='asis'}
source(file.path(here::here(),"utils/derniere_modif.R"))
```

## Contenu de la documentation

**Cette documentation vise à aider les agents à réaliser des traitements statistiques usuels avec `R` et à produire des sorties (graphiques, cartes, documents).** Cette documentation présente succinctement les outils les plus adaptés à ces tâches, et oriente les agents vers les ressources documentaires pertinentes. En revanche, elle n'aborde pas les outils les plus avancés, notamment ceux utilisés dans un cadre de développement logiciel.
Expand Down
4 changes: 4 additions & 0 deletions 01_R_Insee/Travail_avec_R_Insee.qmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Comment travailler avec R à l'Insee ?

```{r, echo=FALSE, results='asis'}
source(file.path(here::here(),"utils/derniere_modif.R"))
```

## Démarrage rapide de `R` à l'Insee

- où clique-t-on pour accéder à Rstudio? Description rapide des environnements: local, AUS, PF innovation.
Expand Down
4 changes: 4 additions & 0 deletions 02_Bonnes_pratiques/01-qualite-code.qmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Qualité du code {#code-quality}

```{r, echo=FALSE, results='asis'}
source(file.path(here::here(),"utils/derniere_modif.R"))
```

::: {.callout-important}
## Tâche concernée et recommandation

Expand Down
4 changes: 4 additions & 0 deletions 02_Bonnes_pratiques/02-nommage.qmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Nommer les objets {.nommage}

```{r, echo=FALSE, results='asis'}
source(file.path(here::here(),"utils/derniere_modif.R"))
```

Un code écrit avec des noms de variables et de fonctions explicites est autant, voire plus, informatif que les commentaires qui l’accompagnent. C'est pourquoi il est essentiel de respecter des conventions pour le choix des noms des objets afin d'assurer la lisibilité des programmes. Sur ce point, il est important de rappeler que **`R` est un langage sensible à la casse**, ce qui signifie que `variable` et `Variable` renvoient à deux objets différents.

Les fonctions de base `R` utilisent des points dans les noms de fonctions ( `contrib.url()` par exemple) ou les noms de classes (`data.frame`). Il est néanmoins mieux de réserver les points uniquement aux objets de classe `S3` sous la forme `fonction.classe`
Expand Down
4 changes: 4 additions & 0 deletions 02_Bonnes_pratiques/03-syntaxe.qmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Rédiger un script `R`

```{r, echo=FALSE, results='asis'}
source(file.path(here::here(),"utils/derniere_modif.R"))
```

## Longueur des lignes

**La longueur maximale recommandée d'une ligne est 80 caractères**. Il faut penser à retourner à la ligne pour que le code soit lisible. Par exemple,
Expand Down
4 changes: 4 additions & 0 deletions 02_Bonnes_pratiques/04-organisation.qmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Comment organiser un code `R`

```{r, echo=FALSE, results='asis'}
source(file.path(here::here(),"utils/derniere_modif.R"))
```

## Lister les dépendances

Il est important de mettre en évidence dans le code la liste des *packages* utilisés, la définition des fonctions (si elles sont utilisées plusieurs fois dans le script) et la définition des paramètres. Cela permet de bien visualiser les *packages* chargés pour un script ainsi que l'ensemble des paramètres à éventuellement modifier/mettre à jour.
Expand Down
4 changes: 4 additions & 0 deletions 03_Fiches_thematiques/Fiche_analyse_de_donnees.qmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# L'analyse de données (ACP, ACM, ACF...) {#acp}

```{r, echo=FALSE, results='asis'}
source(file.path(here::here(),"utils/derniere_modif.R"))
```

## Tâches concernées et recommandations

Vous souhaitez appliquer les méthodes classiques d'analyse de données, notamment l'analyse en composantes principales, l'analyse des correspondances multiples, l'analyse factorielle des correspondances...
Expand Down
4 changes: 4 additions & 0 deletions 03_Fiches_thematiques/Fiche_arrow.qmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Manipuler des données avec `arrow` {#arrow}

```{r, echo=FALSE, results='asis'}
source(file.path(here::here(),"utils/derniere_modif.R"))
```

## Tâches concernées et recommandations

L'utilisateur souhaite manipuler des données structurées sous forme de `data.frame` par le biais de l'écosystème `Arrow` (sélectionner des variables, sélectionner des observations, créer des variables, joindre des tables).
Expand Down
1 change: 1 addition & 0 deletions rproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -48,4 +48,5 @@ dependencies = [
{ name = "melodi", git = "https://github.com/inseefrlab/melodi", branch = "main" },
{ name = "insee", git = "https://github.com/pyr-opendatafr/R-Insee-Data", branch = "master" },
{ name = "OECD", git = "https://github.com/expersso/OECD", branch = "master" },
"here",
]
16 changes: 16 additions & 0 deletions rv.lock
Original file line number Diff line number Diff line change
Expand Up @@ -915,6 +915,15 @@ dependencies = [
"cpp11",
]

[[packages]]
name = "here"
version = "1.0.2"
source = { repository = "https://packagemanager.posit.co/cran/latest" }
force_source = false
dependencies = [
{ name = "rprojroot", requirement = "(>= 2.1.0)" },
]

[[packages]]
name = "highr"
version = "0.12"
Expand Down Expand Up @@ -1671,6 +1680,13 @@ dependencies = [
{ name = "yaml", requirement = "(>= 2.1.19)" },
]

[[packages]]
name = "rprojroot"
version = "2.1.1"
source = { repository = "https://packagemanager.posit.co/cran/latest" }
force_source = false
dependencies = []

[[packages]]
name = "rsdmx"
version = "0.6-5"
Expand Down
7 changes: 7 additions & 0 deletions utils/derniere_modif.R
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# malhereusement nécessaire car knitr::current_input renvoit faussement .rmarkdown
nom_fichier <- sub("rmarkdown", "qmd", knitr::current_input(dir=FALSE))
last_date <- system(paste0("git log -1 --format=%as -- ", nom_fichier), intern = TRUE)
last_date <- format(as.Date(last_date), format = "%d/%m/%Y")
if(length(last_date) > 0) {
cat("**Dernière modification :** ", last_date)
}