mapsf.gui : interface graphique pour la cartographie thématique

Hugues Pecout - Matthieu Viry - Timothée Giraud

Rencontres R 2026, Nantes

16 juin 2026

mapsf.gui est un package qui offre une interface graphique au
package mapsf pour la construction interactive de cartes statistiques
et la production du code associé.

Équipe

Matthieu Viry

Ingénieur de recherche en informatique (UAR RIATE, CNRS)
Développeur d’outils libres de cartographie et d’analyse spatiale
👷 mthh.github.io · magrit.cnrs.fr · mapsf.gui…

Timothée Giraud

Ingénieur de recherche en géomatique (UAR RIATE, CNRS)
Développeur de packages R de cartographie et d’analyse spatiale
👷 rcarto.github.io · maptiles · osrm · maposm · mapsf…

Hugues Pecout

Ingénieur d’études en géomatique (UMR Géographie-cités, CNRS)  
Coordinateur de projets communautaires sur R
👷 rzine.fr · elementr.cnrs.fr

Une équipe constituée de 3 ingénieurs de l’ESR (sciences de l’information géographique et ingénierie logicielle).

Nous donnons régulièrement des formations de cartographie thématique et de spatial data science à des publics variés, disciplines variées, niveau varié (licence, master, doctorat, professionnels, école thématique, jeunes chercheurs).

Nous nous inscrivons dans la science ouverte et la recherche reproductible. Nous produisons des packages de cartographie, de statistiques spatiales depuis 2013.

Une compétence dans les 2 sens : géospatial pour les utilisateurs de R et R pour les géographes

Une expérience dans les interfaces utilisateurs pour la visualisation ou la manipulation de données spatiales

Par exemple, Magrit (https://magrit.cnrs.fr) un logiciel dédié à la réalisation de cartes thématiques / statistiques et à l’enseignement de la cartographie dans l’ESR, utilisé dans de nombreuses formations universitaires en France (et à l’international), développé depuis 2016.

Pourquoi ?

Nos activités de formation et nos interactions avec notre communauté de recherche nous ont convaincu qu’une solution de cartographie thématique interactive produisant du code reproductible manquait à l’écosystème R.

Besoin identifié d’un outil favorisant la découverte et l’apprentissage en autonomie de la pratique de la cartographie thématique avec le langage R.

🎯 Objectifs

Une interface graphique pour :

1. Créer des cartes en autonomie

• En s’appropriant le code produit
• En découvrant les paramètres

2. Plus rapidement !

• Positionnement des éléments
• Gestion des dimensions & marges

Une application pédagogique

accessibles et compréhensibles

plutôt que l’apprentissage de concepts abstraits hors contexte

sans masquer la complexité** du code

Contrairement à une approche vibe coding où le code est généré sans que l’utilisateur·rices en comprenne la structure

D’après Tardif (1998), les « apprentissages situés » ou « Situated learning » s’inscrivent dans des environnements pédagogiques qui tiennent compte des préoccupations des élèves, de la logique de leurs questionnements. Les connaissances construites et les compétences développées dans un tel conS90e sont très signifiantes et il ne s’agit pas d’apprentissages abstraits, mais d’apprentissages-en action et d’apprentissages-à-partir-de-l’action.

(tooltips, documentation intégrée à chaque panneau, etc. - voir plus bas)

mapsf.gui n’a pas pour objectif d’éviter le code, mais plutôt de servir de tremplin pour l’apprivoiser !

📋 Correspondance explicite et permanente avec le code R sous-jacent.

💡 Logique d’apprentissage situé, favorisant la compréhension du code en contexte.

🎨 Design et ergonomie qui rendent les paramètres graphiques accessibles.

Les principales fonctionnalités

🗺️️ Chargement de données spatiales depuis des fichiers ou environnement R

🔨 Construction de différents types de cartes thématiques proposés par mapsf

✏️ Personnalisation des cartes à l’aide des paramètres proposés par mapsf

💥 Génération du code correspondant en temps réel

📋 Copie du code R pour la reproductibilité des cartes créées

💾 Export des cartes (PNG, SVG)

Une interface accessible

🎨 Design fonctionnel

• Design web néo brutaliste.
• Interface conçue pour être immédiatement compréhensible.
• Chaque panneau correspond à une fonction de mapsf

👅 Multilingue

• Anglais, français et espagnol
• Conçu pour accepter des traductions supplémentaires

📚 Documentation intégrée

• Boutons d’aide et tooltip
• Lien vers la documentation mapsf

Une interface accessible

Une documentation intégrée

ℹ️ Un bouton d’aide par panneau

💡 Des tooltips argument = valeur

📖 Lien vers documentation mapsf

Un code propre et lisible

• Ajout de commentaires

• Ajout de sauts de ligne

• Élimination d’arguments
  (si = valeur par défaut)

• Indentation du code

Behind the scenes

Processus de développement

📆 Début en janvier 2026, soumission aux RR2026 fin février.  

✅ 1ère release publique : pour les RencontresR, juin 2026

Workflow agile

User testing

Et effet de bord !

• Lean development
• Continuous feedback

• École doctorale
  
• Master de Géomatique

• GUI = test package
• mapsf v1.2.0 !

• Agile / itératif : cycles courts, feedback continu, pas de spec figée en amont mais une vision claire de l’objectif final

• Lean development : on démarre avec le minimum (sketch papier + idée d’une appli Shiny), on affine par itérations

• Continuous feedback loop : retour hebdomadaire de l’équipe, voir au fil de l’eau (salon Tchap, pas forcément de réunions formelles, etc.)

• Tests utilisateurs exploratoires (exploratory usability testing) : peu de consignes, observation de l’utilisation de l’application par des utilisateurs novices pour identifier les points de friction, les incompréhensions, les bugs, etc.

• Dispositif type think-aloud (invitation à verbaliser pensées, intentions et difficultés pendant l’usage de l’application), pas vraiment de tâches prescrites à l’avance (si ce n’est de faire des cartes !)

• Le GUI comme accélérateur de qualité pour mapsf ? (plus d’utilisateurs × plus d’inputs = plus de bugs remontés !)

• Effet positif sur la qualité du package sous-jacent : en rendant l’exploration des paramètres immédiate et sans friction, le GUI a élargi la surface de test sans effort délibéré

• Les release de mapsf v1.2.0 a été principalement consacrées à la correction de bugs découverts via mapsf.gui

Architecture générale

Application Shiny · Structure modulaire · Utilisation de shiny::reactiveValues()

• Une application Shiny suivant une architecture modulaire
• Utilisation de shiny::reactiveValues pour stocker l’état de l’application (paramètres de visualisation sélectionnés par l’utilisateur.rice), selon une logique de single source of truth

Pipeline de transformation

• Une pipeline de transformation qui convertit les paramètres de visualisation, soit en code R, soit en une carte thématique produite par mapsf (same model, different views / séparation des préoccupations), à chaque modification de l’état de l’application
• Logique d’élimination des valeurs par défaut (les arguments égaux aux défauts de mapsf, extraits depuis la signature des fonctions ainsi que depuis les paramètres du thème choisi par l’utilisateur, sont éliminés du code généré)

Installer mapsf.gui

Version 0.1.0 sur le CRAN

install.packages("mapsf.gui")

Version de développement sur r-universe

install.packages("mapsf.gui", repos = c('https://riatelab.r-universe.dev', 
                                        'https://cloud.r-project.org'))

Ouvrir l’application

mapsf.gui::run_app()

Addin Rstudio IDE

💥 mapsf.gui s’ouvre dans votre naviguateur

Perspectives d’évolution

Une release v0.2.0 avec de nouvelles fonctionnalités ?

• Création d’inset pour les cartes (carton de localisation)

• Gestion des projections cartographiques

• Activer/désactiver l’affichage d’une couche géographique

• Proposer la personnalisation des thèmes graphiques

• Possibilité de charger des données depuis des sources en ligne

• Ajout d’un backend générant le code adapté à Quarto

• Ajout de fonctionnalités et arguments proposés par mapsf

• Ajout de boutons d’aide et tooltips

Retours et suggestions sur codeberg.org/riatelab/mapsf.gui 🙏

mapsf.gui v0.1.0

Viry M, Giraud T, Pecout H (2026). mapsf.gui: Create Thematic Maps Interactively. R package version 0.1.0, https://codeberg.org/riatelab/mapsf.gui.

✅ Version 0.1.0 disponible sur le CRAN

install.packages("mapsf.gui")

✅ Version de développement sur riatelab.r-universe.dev

install.packages("mapsf.gui", 
                 repos = c('https://riatelab.r-universe.dev', 
                           'https://cloud.r-project.org'))

✅ ️Code source sur : codeberg.org/riatelab/mapsf.gui

matthieu.viry@cnrs.fr 
timothee.giraud@cnrs.fr 
hugues.pecout@cnrs.fr