sencensus (R Package)

Un package R permettant de télécharger et d'analyser facilement les données des recensements et autres données démographiques du Sénégal (RGPH). Ce package est l'équivalent du package Python sencensus.

Installation

Le package R n'est pas encore sur le CRAN. Vous pouvez l'installer directement depuis GitHub en utilisant le package remotes :

# Installer le package 'remotes' s'il n'est pas déjà installé
install.packages("remotes")

# Installer sencensus depuis GitHub
remotes::install_github("Amady01/sencusR")

(Si R vous demande de mettre à jour d'autres packages, vous pouvez taper 3 pour dire "None" et gagner du temps).

Utilisation

Une fois installé, vous pouvez utiliser le package pour télécharger, mettre en cache et charger les bases de données du recensement.

1. Charger le package et lister les recensements

library(sencensus)

# Voir tous les jeux de données disponibles
catalogue <- list_census()
print(catalogue)

2. Télécharger et charger les données

Le téléchargement ne se fait qu'une seule fois. Les données sont ensuite mises en cache sur votre ordinateur pour un chargement instantané.

# Exemple pour le RGPH 2023
sencensus::download(2023)
df_2023 <- load_dataset(2023)
head(df_2023)

# Exemple pour les Projections Démographiques (1968-2018)
sencensus::download("projection")
df_pop <- load_dataset("projection")
head(df_pop)

# Exemple pour les Coordonnées Géographiques
sencensus::download("coordonnées")
df_geo <- load_dataset("coordonnées")
head(df_geo)

Note : Si les fichiers ont été mis à jour sur GitHub et que vous souhaitez écraser votre cache local, utilisez force = TRUE :

sencensus::download(2023, force = TRUE)

3. Explorer les Dictionnaires de Variables

Pour comprendre la signification des colonnes et des modalités, vous pouvez interroger les dictionnaires intégrés au package.

# Obtenir le dictionnaire complet pour l'année 2023
dico_2023 <- get_dictionary(2023)
head(dico_2023)

# Chercher une variable spécifique (par mot-clé)
recherche_ethnie <- search_variables("ethnie", 2023)
print(recherche_ethnie)