Aller au contenu
Programmation et automatisation en géomatique · L3

Leçon 1 sur 5

Rappels de Python et bibliothèques géospatiales

Je sais écrire de courts programmes Python qui manipulent des coordonnées, construire des géométries avec Shapely et changer de système de coordonnées avec pyproj.

  • 1 h 20
  • 6 exercices corrigés
  • QCM de 7 questions

À la fin de la leçon, vous saurez :

  • Utiliser les types et structures de Python (listes, tuples, dictionnaires, fonctions) pour représenter des points levés
  • Situer les principales bibliothèques géospatiales libres et leur rôle
  • Construire et mesurer des géométries (points, lignes, polygones) avec Shapely
  • Transformer des coordonnées entre WGS 84 et UTM avec pyproj
  • Calculer et contrôler une surface par la formule du lacet

Avant de commencer : Cours de programmation de L1-L2 (bases de Python) ; cours de géodésie et de SIG (systèmes de coordonnées, projection UTM).

1Je découvre

Un cabinet de géomètres de Kindia vient de remporter le levé d'un lotissement de quarante parcelles à la sortie de la ville. Mariama, technicienne fraîchement diplômée, reçoit chaque soir le fichier des bornes levées au GNSS par l'équipe de terrain : un numéro de borne, une abscisse et une ordonnée en UTM.

Pour la première parcelle, elle ouvre un tableur, recopie les coordonnées, calcule la surface à la main, puis reporte le résultat dans QGIS. Il lui faut vingt minutes. Pour quarante parcelles, cela fait plus de treize heures, avec le risque d'une faute de frappe à chaque recopie. Et le client veut aussi les coordonnées en latitude et longitude pour les publier sur une carte en ligne.

Son chef de service lui dit : « Ce travail, un script de trente lignes le fait en une seconde, et il le refait à l'identique demain si une borne est corrigée. »

Comment Python et ses bibliothèques géospatiales permettent-ils de représenter, mesurer et convertir automatiquement des données de levé ?

2Je comprends

1. Pourquoi programmer en géomatique ?

Un logiciel SIG avec interface graphique suffit pour un traitement ponctuel. Dès qu'un traitement doit être répété (quarante parcelles, cent images, une mise à jour chaque semaine), la programmation apporte quatre avantages :

AvantageSignificationExemple sur le lotissement de Kindia
Gain de tempsla machine répète sans se fatiguerquarante surfaces calculées en une seconde
Reproductibilitéle même script donne le même résultatrefaire le calcul après correction d'une borne
Traçabilitéle script documente chaque étapele client peut vérifier la méthode
Contrôle qualitéon programme des tests automatiquessignaler une parcelle non fermée ou une surface aberrante

Python est devenu le langage de référence de la géomatique : il est libre, lisible, et c'est le langage de script de QGIS (leçon 3) comme d'ArcGIS.

2. Rappels de Python utiles au géomaticien

Une coordonnée plane se représente naturellement par un tuple (non modifiable) ; une suite de bornes par une liste ; une borne avec ses attributs par un dictionnaire.

b1 = (735120.00, 1112340.00)          # tuple (E, N) en mètres
parcelle = [b1, (735160.00, 1112345.00), (735155.00, 1112380.00), (735118.00, 1112372.00)]
borne = {"num": "B1", "E": 735120.00, "N": 1112340.00, "nature": "borne béton"}

for i, (e, n) in enumerate(parcelle, start=1):
    print(f"B{i} : E = {e:.2f} m ; N = {n:.2f} m")

nords = [n for (e, n) in parcelle]     # compréhension de liste
print(max(nords) - min(nords))         # étendue en Y : 40.0 m

Rappels essentiels :

  • les indices commencent à 0 ; parcelle[-1] est le dernier élément ;
  • une fonction se définit par def nom(paramètres): et renvoie un résultat avec return ;
  • f"{x:.2f}" affiche un nombre avec deux décimales (le centimètre, en topographie) ;
  • le module standard math fournit math.dist, math.atan2, math.degrees, math.hypot.

Calcul de la distance et du gisement entre deux bornes. Le gisement se compte depuis le nord, dans le sens horaire, d'où l'ordre des arguments atan2(Δ E, Δ N) :

import math

def distance_gisement(p, q):
    dE, dN = q[0] - p[0], q[1] - p[1]
    d = math.hypot(dE, dN)
    g = math.degrees(math.atan2(dE, dN)) % 360   # en degrés, de 0 à 360
    return d, g

3. L'écosystème géospatial libre en Python

Presque toutes les bibliothèques reposent sur trois briques écrites en C/C++ : GDAL/OGR (lecture et écriture de formats), GEOS (opérations géométriques) et PROJ (systèmes de coordonnées).

BibliothèqueRôleBrique sous-jacente
Shapelygéométries vectorielles et opérations (aire, tampon, intersection)GEOS
pyprojsystèmes de coordonnées et transformationsPROJ
Fiona ou pyogriolecture et écriture de fichiers vecteurGDAL/OGR
GeoPandastables attributaires avec une colonne géométrieShapely, pyproj, pyogrio
rasteriolecture et écriture de rastersGDAL
NumPycalcul sur des tableaux de nombres (pixels)—
foliumcartes web interactives depuis Python (leçon 4)Leaflet
PyQGISpilotage de QGIS (leçon 3)QGIS

Installation recommandée : un environnement isolé (par exemple avec conda et le canal conda-forge, ou venv et pip) pour éviter les conflits de versions entre GDAL, PROJ et les bibliothèques Python.

4. Construire et mesurer des géométries avec Shapely

Shapely suit le modèle Simple Features de l'OGC : Point, LineString, Polygon et leurs versions multiples (MultiPoint, MultiLineString, MultiPolygon).

from shapely.geometry import Point, LineString, Polygon

p = Polygon(parcelle)            # le polygone se ferme automatiquement
print(p.area)                    # 1312.5 (m², car les coordonnées sont en mètres)
print(round(p.length, 2))        # 145.58 (périmètre en m)
print(p.is_valid)                # True
puits = Point(735140, 1112360)
print(p.contains(puits))         # True
zone = p.buffer(5)               # zone de 5 m autour de la parcelle

Point capital : Shapely ne connaît pas le système de coordonnées. Il calcule dans le plan, avec les unités des coordonnées. Une aire calculée sur des longitudes et latitudes en degrés n'a aucun sens en mètres carrés.

La surface d'un polygone de sommets (xi, yi) est donnée par la formule du lacet (ou de Gauss) :

S = 12|Σi=1n (xi yi+1 - xi+1 yi)| avec (xn+1, yn+1) = (x1, y1)

Le signe de la somme avant la valeur absolue indique le sens de parcours : positif dans le sens trigonométrique, négatif dans le sens horaire.

Exemple

Surface de la parcelle P1 (bornes B1 à B4, coordonnées UTM en m).

Étape 1 — Pour limiter les erreurs d'arrondi, on retranche une origine locale (735100 ; 1112300) :

B1 (20 ; 40), B2 (60 ; 45), B3 (55 ; 80), B4 (18 ; 72).

Étape 2 — Produits croisés x_i·y_(i+1) − x_(i+1)·y_i :

B1→B2 : 20×45 − 60×40 = 900 − 2400 = −1500

B2→B3 : 60×80 − 55×45 = 4800 − 2475 = 2325

B3→B4 : 55×72 − 18×80 = 3960 − 1440 = 2520

B4→B1 : 18×40 − 20×72 = 720 − 1440 = −720

Étape 3 — Somme : −1500 + 2325 + 2520 − 720 = 2625 (positive : sens trigonométrique).

Étape 4 — S = 2625 / 2 = 1312,5 m², soit 13 a 12 ca 50 dm².

Contrôle : Shapely renvoie la même valeur, 1312.5. Une translation ne change pas la surface.

5. Changer de système de coordonnées avec pyproj

Chaque système est identifié par un code EPSG. Ceux que l'on rencontre le plus en Guinée :

Code EPSGSystèmeUnitésUsage
4326WGS 84 géographiquedegrésGNSS, GeoJSON, échanges
32628WGS 84 / UTM zone 28Nmètresouest du pays (méridien central 15° O) : Conakry, Kindia, Boké, Labé
32629WGS 84 / UTM zone 29Nmètresest du pays (méridien central 9° O) : Kankan, N'Zérékoré
3857Pseudo-Mercator (Web Mercator)mètresfonds de carte web (leçon 4)

La limite entre les zones 28 et 29 est le méridien 12° O. Un projet qui couvre tout le pays doit choisir une seule zone (ou un système adapté) et s'y tenir.

from pyproj import Transformer

t = Transformer.from_crs("EPSG:32628", "EPSG:4326", always_xy=True)
lon, lat = t.transform(735120.00, 1112340.00)
print(f"{lon:.6f} {lat:.6f}")    # -12.854764 10.055703

L'option always_xy=True impose l'ordre (x, y), c'est-à-dire (longitude, latitude) : sans elle, pyproj respecte l'ordre officiel de l'EPSG 4326, qui est (latitude, longitude), source d'erreurs très fréquentes.

Méthode

Pour traiter un fichier de bornes avec Python :

  1. Identifier le système de coordonnées des données (code EPSG) et l'unité.
  2. Lire les bornes dans une structure (liste de tuples ou de dictionnaires).
  3. Contrôler : nombre de bornes, doublons, valeurs dans l'emprise attendue.
  4. Construire les géométries (Shapely) dans un système projeté en mètres.
  5. Mesurer (surface, périmètre) et tester la validité.
  6. Transformer vers le système demandé (pyproj, always_xy=True) seulement pour l'export.
  7. Afficher ou enregistrer les résultats avec un nombre de décimales cohérent avec la précision du levé.

6. Écrire un script propre

Un script professionnel est relu, réutilisé et modifié par d'autres. Quelques règles :

  • des noms explicites (surface_m2, pas s) et des commentaires sur le pourquoi ;
  • des fonctions courtes, chacune avec une seule tâche, testables séparément ;
  • les paramètres (chemins, code EPSG, tolérances) regroupés en tête du script ;
  • un contrôle des erreurs : try / except pour un fichier absent, assert pour une condition qui doit être vraie ;
  • un suivi des versions (Git) et un fichier qui liste les bibliothèques et leurs versions.

3Je retiens

Je retiens

Programmer rend un traitement rapide, reproductible, traçable et contrôlable.

Tuple pour une coordonnée, liste pour une suite de bornes, dictionnaire pour une borne et ses attributs.

GDAL/OGR (formats), GEOS (géométrie) et PROJ (projections) sont les briques de base.

Shapely calcule dans le plan, sans connaître le système de coordonnées.

On mesure surfaces et distances dans un système projeté en mètres, jamais en degrés.

Formule du lacet : S = moitié de la valeur absolue de la somme des produits croisés.

Guinée : UTM 28N (EPSG 32628) à l'ouest de 12° O, UTM 29N (EPSG 32629) à l'est.

Avec pyproj, always_xy=True impose l'ordre longitude, latitude.

4Erreurs fréquentes

  • Calculer une aire avec Shapely sur des coordonnées en degrés : le résultat n'est pas en m².
  • Oublier always_xy=True et inverser latitude et longitude.
  • Mélanger dans un même projet des données en UTM 28N et en UTM 29N sans les reprojeter.
  • Utiliser atan2(dN, dE) pour un gisement : il faut atan2(dE, dN), compté depuis le nord.
  • Afficher des coordonnées au micromètre alors que le levé est précis au centimètre.
  • Coder en dur les chemins et les codes EPSG au milieu du script au lieu de les regrouper en tête.

5Je m’exerce

1Exercice 1

(Questions de cours)

a) Citez les trois briques logicielles sur lesquelles reposent la plupart des bibliothèques géospatiales et le rôle de chacune.

b) Pourquoi l'option always_xy=True est-elle recommandée avec pyproj ?

c) Dans quelle zone UTM se trouvent Labé et Kankan ? Donnez les codes EPSG correspondants.

Voir le corrigéCacher le corrigé

a) GDAL/OGR lit et écrit les formats raster (GDAL) et vecteur (OGR) ; GEOS réalise les opérations géométriques (aire, intersection, tampon) ; PROJ gère les systèmes de coordonnées et les transformations. b) Parce que l'EPSG 4326 définit officiellement l'ordre (latitude, longitude) ; always_xy=True force l'ordre (x, y) = (longitude, latitude), cohérent avec les SIG et le GeoJSON. c) Labé (environ 12,3° O) est à l'ouest du méridien 12° O : zone 28N, EPSG 32628. Kankan (environ 9,3° O) est en zone 29N, EPSG 32629.

2Exercice 2

On donne les bornes A (100 ; 100), B (130 ; 100), C (130 ; 120), D (100 ; 120), en mètres.

a) Calculez la surface par la formule du lacet en parcourant A, B, C, D.

b) Quel est le signe de la somme ? Que devient-il si l'on parcourt A, D, C, B ?

Voir le corrigéCacher le corrigé

a) Produits croisés : A→B : 100×100 − 130×100 = −3000 ; B→C : 130×120 − 130×100 = 2600 ; C→D : 130×120 − 100×120 = 3600 ; D→A : 100×100 − 100×120 = −2000. Somme = −3000 + 2600 + 3600 − 2000 = 1200. S = 1200 / 2 = 600 m² (rectangle de 30 m × 20 m : contrôle exact). b) La somme est positive : parcours dans le sens trigonométrique. En parcourant A, D, C, B (sens horaire), la somme vaut −1200 ; la surface reste 600 m².

3Exercice 3

Écrivez une fonction Python surface_lacet(points) qui reçoit une liste de tuples (x, y) et renvoie la surface (positive) du polygone, sans utiliser Shapely. Testez-la sur la parcelle P1 de la leçon.

Voir le corrigéCacher le corrigé
def surface_lacet(points):
    n = len(points)
    s = 0.0
    for i in range(n):
        x1, y1 = points[i]
        x2, y2 = points[(i + 1) % n]   # le modulo referme le polygone
        s += x1 * y2 - x2 * y1
    return abs(s) / 2

parcelle = [(735120.0, 1112340.0), (735160.0, 1112345.0), (735155.0, 1112380.0), (735118.0, 1112372.0)]
print(surface_lacet(parcelle))   # 1312.5

Pour de grandes coordonnées, on peut d'abord retrancher le premier point à tous les sommets afin de limiter les erreurs d'arrondi.

4Exercice 4

À l'aide de la fonction distance_gisement de la leçon, calculez à la main la distance et le gisement de B1 (735120,00 ; 1112340,00) vers B2 (735160,00 ; 1112345,00). Arrondissez la distance au centimètre et le gisement au centième de degré.

Voir le corrigéCacher le corrigé

ΔE = 40,00 m ; ΔN = 5,00 m. Distance : √402 + 52 = √1625 ≈ 40,31 m. Gisement : atan2(40, 5) = arctan(40/5) = arctan 8 ≈ 82,87° (ΔE et ΔN positifs : premier quadrant, aucune correction). B2 est donc presque plein est de B1, légèrement vers le nord.

5Exercice 5

Un stagiaire écrit :

p = Polygon([(-12.8548, 10.0557), (-12.8544, 10.0557), (-12.8544, 10.0561)])
print(p.area, "m²")

Le résultat affiché est environ 8e-08. Expliquez l'erreur et proposez une correction.

Voir le corrigéCacher le corrigé

Les coordonnées sont des longitudes et latitudes en degrés : Shapely calcule une aire en « degrés carrés », qui n'a pas de sens physique (et un degré de longitude n'a pas la même longueur qu'un degré de latitude). Correction : transformer d'abord les sommets en UTM 28N avec pyproj (`Transformer.from_crs("EPSG:4326", "EPSG:32628", always_xy=True)`), construire le polygone avec les coordonnées obtenues, puis calculer l'aire, qui sera en m².

6Exercice 6

(Type examen) Le cabinet de Kindia reçoit un fichier de bornes sous la forme d'une liste de dictionnaires :

`bornes = [{"num": "B1", "E": 735120.0, "N": 1112340.0}, {"num": "B2", "E": 735160.0, "N": 1112345.0}, {"num": "B3", "E": 735155.0, "N": 1112380.0}, {"num": "B4", "E": 735118.0, "N": 1112372.0}]`

a) Écrivez le code qui construit le polygone Shapely de la parcelle et affiche sa surface et son périmètre arrondis au centième.

b) Écrivez le code qui ajoute à chaque dictionnaire les clés "lon" et "lat" (WGS 84).

c) Ajoutez un contrôle qui lève une erreur si le polygone n'est pas valide.

d) Expliquez pourquoi la surface doit être calculée avant la conversion en WGS 84.

Voir le corrigéCacher le corrigé

a)

from shapely.geometry import Polygon
coords = [(b["E"], b["N"]) for b in bornes]
p = Polygon(coords)
print(f"Surface : {p.area:.2f} m² ; périmètre : {p.length:.2f} m")
# Surface : 1312.50 m² ; périmètre : 145.58 m

b)

from pyproj import Transformer
t = Transformer.from_crs("EPSG:32628", "EPSG:4326", always_xy=True)
for b in bornes:
    b["lon"], b["lat"] = t.transform(b["E"], b["N"])

Pour B1, on obtient environ lon = −12,854764 et lat = 10,055703.

c)

if not p.is_valid:
    raise ValueError("Parcelle invalide : vérifier l'ordre des bornes")

d) La surface n'a de sens qu'en coordonnées planes métriques. En WGS 84, les coordonnées sont angulaires : l'aire calculée par Shapely serait en degrés carrés. On calcule donc dans le système projeté du levé (UTM 28N) et on ne convertit qu'à la fin, pour l'export.

Cherchez d’abord seul, sur votre cahier, puis ouvrez le corrigé pour comparer.

6Je vérifie

Choisissez une réponse pour chaque question : la correction s’affiche aussitôt.

1Quelle bibliothèque Python gère les transformations de systèmes de coordonnées ?
Voir la réponse

Réponse B : pyproj. pyproj est l'interface Python de PROJ.

2Un polygone a des coordonnées en mètres (UTM). Que renvoie p.area ?
Voir la réponse

Réponse A : une surface en m². Shapely calcule dans les unités des coordonnées : mètres, donc m².

3Quel code EPSG convient à un levé à N'Zérékoré ?
Voir la réponse

Réponse B : 32629. N'Zérékoré (vers 8,8° O) est à l'est de 12° O : UTM zone 29N.

4Que fait always_xy=True dans pyproj ?
Voir la réponse

Réponse B : il impose l'ordre longitude, latitude (x, y). Sans cette option, l'EPSG 4326 attend (latitude, longitude).

5La formule du lacet donne une somme négative. Cela signifie :
Voir la réponse

Réponse B : que les sommets sont parcourus dans le sens horaire. Le signe indique le sens de parcours ; la surface est la valeur absolue divisée par 2.

6Quelle brique logicielle réalise les opérations géométriques utilisées par Shapely ?
Voir la réponse

Réponse C : GEOS. Shapely s'appuie sur GEOS pour les aires, tampons et intersections.

7Quelle structure Python convient le mieux à une borne avec son numéro, ses coordonnées et sa nature ?
Voir la réponse

Réponse B : un dictionnaire. Le dictionnaire associe chaque attribut à un nom de clé.

Karamö, votre enseignant

Il a lu cette leçon. Posez-lui votre question : il vous répond ici.

Connectez-vous pour poser vos questions à Karamö.

Vous avez fini la leçon ?

Avec un compte Kharandi gratuit, vous cochez les leçons terminées et vous suivez votre progression, cours par cours.

Karamö
Un point pas clair ? Dites à Karamö ce qui vous bloque dans cette leçon : il vous l’explique autrement, pas à pas, sans faire le travail à votre place. Demander à Karamö
Signaler une erreur dans cette leçon

Toutes les leçons de Programmation et automatisation en géomatique

Pose ta question à Karamö