🚌 Projet MDM - Mobilité Durable en Montagne ⛰️

En collaboration avec :

• DataForGood Grenoble : https://data-for-good-grenoble.github.io/
• CampToCamp : https://www.camptocamp.org/
• ProtectOurWinters : https://protectourwinters.fr/

Spécial remerciement :

• https://transport.data.gouv.fr

📊 Exploration des données

Les notebooks d’analyse de données sont regroupés dans le dossier src/notebooks.

⚠️ Attention à la gestion de version des notebooks Jupyter : en raison des risques fréquents de conflits lors des modifications, il est recommandé de créer un nouveau notebook plutôt que de modifier un notebook existant que vous n’avez pas vous-même créé. Une fusion des différentes versions sera effectuée ultérieurement si nécessaire.

🗂️ Nomenclature des notebooks

Pour faciliter la collaboration et le suivi des modifications, les notebooks doivent être nommés selon la convention suivante :

<date>_<auteur>_<feature>.ipynb

• date : au format YYYY-MM-DD (exemple 2025-06-19)
• auteur : prénom ou identifiant Git (exemple AReboud)
• feature : description courte (exemple EPSG)

2025-06-19_AReboud_EPSG.ipynb

Processus et objectifs

Voir diagramme Processus et objectifs

Installation

Dépendances

Python 3.13
uv, le gestionnaire de paquet

Générer l'environnement virtuel

uv sync
uv pip install ".[dev,test]"

Activer l'environnement virtuel

macOS and Linux:

source .venv/bin/activate

windows:

.venv\Scripts\activate

Installer et synchroniser avec Git LFS

Git LFS permet de stocker des fichiers volumineux sur GitHub en ne stockant que les pointeurs vers ces fichiers dans git. Plus d'infos.

Installer git lfs sur votre machine

Linux

sudo apt install git-lfs

ou

sudo yum install git-lfs

Pour Windows, git lfs est déjà inclus dans Git for Windows

Installer git lfs dans le projet et récupérer les fichiers

Pour installer Git LFS:

git lfs install

Pour synchroniser les fichiers suivis par LFS :

git lfs pull

Mettre un nouveau type de fichiers sur git lfs

On peut ajouter un nouveau type de fichiers géré par git lfs avec la commande git lfs add ou en modificant directement le fichier .gitattributes.

Exécuter un script

python main.py path/to/script.py

ou si on n'a pas activé l'environnement

uv run main.py path/to/script.py

Activation du pre-commit

pre-commit install

Jouer avec Jupyter Lab

macOS and Linux:

.venv/bin/jupyter lab

windows:

.venv\Scripts\jupyter lab

Tests

uv run pytest

Scrapping

Voir le README du sous-dossier.

Doc utile

• Format GTFS : https://gtfs.org/documentation/schedule/reference/
• gtfs-kit : https://github.com/mrcagney/gtfs_kit
• …

Repère géospatial

Le repère géospatial par défaut du projet est

EPSG:3857

C'est lui que l'on doit trouver dans les différents jeux de données. Celui-ci est optimisé pour la visualisation des données sur écran.

Lors des calculs géospatiaux, ce repère est source d'erreur, dans ce cas, on utilise le

EPSG:4326