Installation

Installer cartograpy et préparer son environnement Python.

Cette page présente le parcours d’installation recommandé pour utiliser cartograpy en local.

Pré-requis

  • Python 3.11 ou supérieur
  • Un environnement virtuel dédié (venv, conda ou uv)
  • Les bibliothèques système requises par geopandas, rasterio, fiona et cartopy (GDAL, GEOS, PROJ) : voir la section par plateforme ci-dessous

Installation rapide

cartograpy est publié sur PyPI : il n’existe pas de paquet conda-forge, donc conda/uv servent ici à créer l’environnement, pip reste l’outil qui installe cartograpy lui-même.

pip install cartograpy
conda create -n cartograpy python=3.11
conda activate cartograpy
pip install cartograpy
Astuce

Sur Windows, si pip install cartograpy échoue à cause de GDAL/GEOS/PROJ, installez d’abord ces dépendances binaires via le canal conda-forge (voir la section Dépendances par plateforme ci-dessous) avant de relancer pip install cartograpy dans l’environnement conda.

uv venv --python 3.11
uv pip install cartograpy

Dans un projet géré par uv (avec pyproject.toml) :

uv add cartograpy

Installation pour le développement

git clone https://github.com/mr-kam/cartograpy.git
cd cartograpy
pip install -e .[dev]

[dev] ajoute pytest, black, flake8, mypy et jupyterlab : nécessaires pour contribuer, inutiles pour un simple usage du package.

Dépendances par plateforme

Les roues précompilées (.whl) de geopandas, rasterio, fiona, cartopy et pyproj couvrent la majorité des cas via pip install cartograpy directement : aucune compilation locale requise dans la plupart des configurations récentes de Python 3.11+/pip.

Astuce

En cas d’échec d’installation (erreurs de compilation liées à GDAL/GEOS/PROJ), passez par conda/mamba (canal conda-forge) qui gère ces dépendances binaires plus fiablement que pip sur Windows :

conda install -c conda-forge geopandas rasterio cartopy fiona
pip install cartograpy --no-deps
pip install cartograpy  # puis les dépendances Python restantes

Installez GDAL/GEOS/PROJ via Homebrew avant pip install cartograpy si vous n’utilisez pas de roues précompilées :

brew install gdal geos proj
pip install cartograpy

Selon la distribution, installez les bibliothèques de développement avant pip install cartograpy :

# Debian / Ubuntu
sudo apt-get install libgdal-dev libgeos-dev libproj-dev

pip install cartograpy

Dépendances importantes

  • geopandas pour les données vectorielles
  • rasterio pour les rasters
  • cartopy et matplotlib pour les cartes statiques
  • folium (via WebMap) et geemap pour les usages web et Google Earth Engine
  • geohexgrid pour les grilles hexagonales / hexbin
  • scienceplots et mplcyberpunk pour les styles graphiques de styling

Voir Sources de données et dépendances pour la liste complète et les dépendances optionnelles (contextily, matplotlib-scalebar, earthengine-api).

Jupyter et Marimo

jupyter et marimo font partie des dépendances cœur : aucune installation supplémentaire n’est nécessaire pour utiliser cartograpy dans un notebook.

jupyter lab
marimo edit mon_notebook.py

Vérifier l’installation

import cartograpy as cp

print(cp.__version__)                  # ex. "2.0.0"
print(cp.COUNTRY_ISO3["france"])       # "fra"
Note

Si cet import échoue avec une erreur liée à GDAL, GEOS ou PROJ, le problème vient des dépendances système (voir la section par plateforme ci-dessus), pas de cartograpy lui-même.