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 :
| Avantage | Signification | Exemple sur le lotissement de Kindia |
|---|---|---|
| Gain de temps | la machine répète sans se fatiguer | quarante surfaces calculées en une seconde |
| Reproductibilité | le même script donne le même résultat | refaire le calcul après correction d'une borne |
| Traçabilité | le script documente chaque étape | le client peut vérifier la méthode |
| Contrôle qualité | on programme des tests automatiques | signaler 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 mRappels 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 avecreturn; f"{x:.2f}"affiche un nombre avec deux décimales (le centimètre, en topographie) ;- le module standard
mathfournitmath.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, g3. 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èque | Rôle | Brique sous-jacente |
|---|---|---|
| Shapely | géométries vectorielles et opérations (aire, tampon, intersection) | GEOS |
| pyproj | systèmes de coordonnées et transformations | PROJ |
| Fiona ou pyogrio | lecture et écriture de fichiers vecteur | GDAL/OGR |
| GeoPandas | tables attributaires avec une colonne géométrie | Shapely, pyproj, pyogrio |
| rasterio | lecture et écriture de rasters | GDAL |
| NumPy | calcul sur des tableaux de nombres (pixels) | — |
| folium | cartes web interactives depuis Python (leçon 4) | Leaflet |
| PyQGIS | pilotage 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 parcellePoint 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 EPSG | Système | Unités | Usage |
|---|---|---|---|
| 4326 | WGS 84 géographique | degrés | GNSS, GeoJSON, échanges |
| 32628 | WGS 84 / UTM zone 28N | mètres | ouest du pays (méridien central 15° O) : Conakry, Kindia, Boké, Labé |
| 32629 | WGS 84 / UTM zone 29N | mètres | est du pays (méridien central 9° O) : Kankan, N'Zérékoré |
| 3857 | Pseudo-Mercator (Web Mercator) | mètres | fonds 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.055703L'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 :
- Identifier le système de coordonnées des données (code EPSG) et l'unité.
- Lire les bornes dans une structure (liste de tuples ou de dictionnaires).
- Contrôler : nombre de bornes, doublons, valeurs dans l'emprise attendue.
- Construire les géométries (Shapely) dans un système projeté en mètres.
- Mesurer (surface, périmètre) et tester la validité.
- Transformer vers le système demandé (pyproj, always_xy=True) seulement pour l'export.
- 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, pass) 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/exceptpour un fichier absent,assertpour 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.5Pour 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 mb)
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.
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ö.
Avec un compte Kharandi gratuit, vous cochez les leçons terminées et vous suivez votre progression, cours par cours.
Signaler une erreur dans cette leçon
Toutes les leçons de Programmation et automatisation en géomatique