Installation¶

Cette page détaille l'environnement technique. Pour une reprise rapide, commencer par Démarrage rapide.

Version Python¶

Le modèle ReLUT repose sur TensorFlow/Keras. L'environnement recommandé est Python 3.10.

Sur la machine de référence, python3 peut pointer vers une version trop récente pour TensorFlow. Utiliser explicitement Python 3.10 :

/opt/homebrew/bin/python3.10 -m venv .venv-parking-search
source .venv-parking-search/bin/activate
python -m pip install --upgrade pip setuptools wheel
python -m pip install -r requirements.txt

Installer ensuite le kernel Jupyter :

python -m ipykernel install --sys-prefix \
  --name parking-search \
  --display-name "Python (parking-search)"

Dépendances principales¶

Dépendance	Rôle
`tensorflow`, `keras`	chargement et exécution du modèle ReLUT `.h5`
`pandas`, `numpy`, `pyarrow`	préparation tabulaire, timestamps et exports Parquet
`geopandas`, `shapely`	traitement géométrique des legs et portions
`h3`, `folium`	agrégations spatiales et cartes HTML
`matplotlib`, `seaborn`	figures de contrôle et de restitution
`mkdocs`, `mkdocs-material`	documentation locale
`pytest`	tests locaux

Dépôts externes¶

Les dépôts externes sont placés dans External/. Ils ne sont pas versionnés dans le dépôt courant.

Le dépôt ReLUT est nécessaire pour le modèle temporel :

mkdir -p External
git clone https://github.com/ReLUT/parking-search-prediction.git \
  External/parking-search-prediction

Le fichier utilisé par le pipeline est :

External/parking-search-prediction/model/ParkingSearchPrediction.h5

Le dépôt archivé External/parking_cruising/, lorsqu'il existe localement, sert uniquement de référence historique pour l'ancien temps géométrique. Le pipeline actif ne doit pas dépendre d'une exécution manuelle dans ce dossier.

Routage local¶

Le routage dist_excess dépend d'une instance OSRM/xyt_routing locale. Cette instance n'est pas nécessaire pour relire le projet si le cache routé est fourni avec les données.

Pour la version de données d'août 2026, utiliser le cache existant plutôt que relancer le routage :

Output/data/routing_results.parquet

Relancer le routage seulement si :

les données d'entrée changent ;
les seuils qui définissent les candidates de routage changent ;
le graphe routier doit être remplacé ;
une vérification méthodologique impose un recalcul complet.

Contrôle d'installation¶

source .venv-parking-search/bin/activate
PYTHONPATH=src python -m pytest tests
mkdocs build --clean --strict

Si ces commandes passent, l'environnement est prêt pour la relecture des notebooks.