Notebook et programmation lettrée
  • Code source
  • Ouvrir une issue
  1. Pratique individuelle
  2. Introduction
  3. Présentation
  • Pratique individuelle
    • Introduction
      • Présentation
      • Environnement
      • Données
    • Notebook
      • Opt1 - Quarto + R
      • Opt2 - Jupyter + Python
    • Forge logicielle
      • Création dépôt
      • CI/CD
      • .gitignore
  • Pratique collective
    • Présentation
    • Environnement
    • Exercice
  • Pour aller plus loin…
    • CI/CD avancé
    • Environnements virtuels
  1. Pratique individuelle
  2. Introduction
  3. Présentation

Présentation


Vous allez devoir transposer une chaîne de traitement contenue dans un fichier de script classique, dans un fichier notebook. L’idée est de transposer un script de code peu commenté dans un document computationnel mis en page et qui présente de manière clair et intelligible la chaîne de traitement proposée, en suivant le paradigme de la programmation lettrée. Un fois le notebook construit, vous allez devoir l’ajouter sur un dépôt de forge logicielle et déployer le document gmis en page sur un GitPage (page web).

Déroulé de l’atelier :

  1. Création d’un notebook en local;
  2. Construction du notebook;
  3. Stockage du notebook sur une forge logicielle;
  4. Déploiement du document HTML sur une GitPage.


La chaîne de traitement proposée

La programmation d’une chaîne de traitement n’est pas au coeur de cette atelier. Pour cette raison, nous vous en fournissons une toute prête. Cette chaîne de traitement tente de répondre au probléme suivant :

Alors que l’été approche, R.L.G, professeur de géographie dans une université parisienne, est tiraillé entre la participation à deux événements professionnels passionnants pour terminer l’année : l’école thématique organisée par l’UAR qu’il dirige ou à l’assemblée générale de son UMR ?

Mais R.L.G peut-il envisager de faire acte de présence aux deux évenements qui se déroulent tous les deux sur l’Ile d’Oléron ?

Pour tenter de lui apporter une réponse, ses ingénieurs ont construit un script qui permet de calculer l’itinéraire, la distance et le temps de déplacement estimés entre les localisation de ces deux évenements…

Plus court itinéraire entre l’école thématique et l’AG de son UMR


Vous allez donc devoir transposer cette chaîne de traitement dans un notebook clair et intelligble car R.L.G n’aura pas le temps de mettre les mains dans le code et souhaite prendre rapidement sa décision à l’aide du document final compilé !


En R ou en Python

Pour cette mise en application, deux options sont possibles en fonction du langage de programmation que vous souhaitez utiliser. Vous pouvez choisir de construire un notebook :

  • Quarto, contenant du code R;
  • ou Jupyter, contenant du code Python


Exemple de résultats attendus

Quarto & R : Ou Jupyter & Python
Fichier script classique mis à disposition script.r script.py
Exemple de code source du notebook à construire Dépôt Gitlab Dépôt Gitlab
Exemple de Notebook compilé et déployé sur une GitPage Gitpage Gitpage


 

Produit par le GT Notebook avec Quarto - 2025