Aller au contenu

Automatiser l'export PDF de 78 cartes avec PyQGIS

Dans le cadre d'un projet de cartographie pédologique couvrant 78 parcelles sur 3 régions du Sénégal, j'avais besoin de générer 78 PDF de cartes individuelles automatiquement depuis QGIS. Voici exactement comment j'ai procédé.

Le contexte · The context

Le projet consistait à cartographier 11 paramètres de fertilité des sols (N, P, K, Ca, Mg, Na, S, MO, CEC, pH, CE) sur 78 parcelles réparties dans 3 régions. Chaque parcelle devait avoir sa propre fiche cartographique en PDF, avec les valeurs du paramètre, la légende et les métadonnées de la parcelle.

Faire ça manuellement = 78 exports × 11 paramètres = 858 opérations. Inacceptable.

La solution : Atlas QGIS + PyQGIS · The solution: QGIS Atlas + PyQGIS

1. Configurer l'Atlas dans QGIS · Set up Atlas in QGIS

Dans le gestionnaire de mise en page (Print Layout) :

  1. Activer Atlas dans le panneau de droite
  2. Définir la couche de couverture : ta couche de parcelles
  3. Cocher Trier par : identifiant de parcelle

2. Expressions dynamiques dans la mise en page · Dynamic expressions in the layout

Pour afficher automatiquement les valeurs d'une parcelle dans le layout, utilise l'expression aggregate() combinée à @atlas_featureid :

[% aggregate(
    layer := 'parcelles',
    aggregate := 'mean',
    expression := "valeur_n",
    filter := $id = @atlas_featureid
) %]

Pour les titres de page dynamiques avec @layout_page :

[% 'Parcelle N°' || @atlas_featurenumber || ' — Page ' || @layout_page %]

3. Le script PyQGIS · The PyQGIS script

Une fois l'Atlas configuré dans l'interface, lance l'export en batch depuis la console Python de QGIS :

from qgis.core import QgsProject, QgsPrintLayout, QgsLayoutExporter
import os

# Charger le projet et la mise en page
project = QgsProject.instance()
layout_name = "Fiche_Pedologique"  # nom de ton layout
output_dir = "C:/output/cartes_pdf/"  # dossier de sortie

# Récupérer la mise en page
manager = project.layoutManager()
layout = manager.layoutByName(layout_name)

if layout is None:
    print(f"Layout '{layout_name}' introuvable.")
else:
    atlas = layout.atlas()
    atlas.setEnabled(True)

    # Paramètres d'export PDF
    exporter = QgsLayoutExporter(layout)
    settings = QgsLayoutExporter.PdfExportSettings()
    settings.dpi = 300
    settings.forceVectorOutput = False

    os.makedirs(output_dir, exist_ok=True)

    # Boucle sur toutes les entités de l'Atlas
    atlas.beginRender()
    atlas.first()

    while True:
        # Nom du fichier basé sur un attribut de la parcelle
        feature = atlas.currentFeature()
        parcel_id = feature["id_parcelle"]
        filename = os.path.join(output_dir, f"parcelle_{parcel_id}.pdf")

        result = exporter.exportToPdf(filename, settings)

        if result == QgsLayoutExporter.Success:
            print(f"✓ Exporté : {filename}")
        else:
            print(f"✗ Erreur pour la parcelle {parcel_id}")

        if not atlas.next():
            break

    atlas.endRender()
    print("Export terminé.")

4. Résultat · Result

  • 78 PDF générés en moins de 4 minutes
  • Nommage automatique par identifiant de parcelle
  • Résolution 300 DPI prête pour impression

Points d'attention · Watch out for

Chemins de fichiers · File paths

Sur Windows, utilise des slashs / ou doubles backslashs \\ dans les chemins Python. Un seul \ provoque des erreurs silencieuses.
On Windows, use forward slashes / or double backslashes \\ in Python paths.

Pour aller plus loin · Going further

  • Adapter le script pour exporter en PNG ou SVG : remplace exportToPdf par exportToImage
  • Ajouter un paramètre de filtre pour n'exporter que les parcelles d'une région donnée
  • Générer un fichier de log CSV avec le statut de chaque export

Article rédigé à partir d'un projet réel de cartographie pédologique au Sénégal (2025).

Partager cet article

Commentaires