GDAL

Ce que c'est

GDAL, abréviation de Geospatial Data Abstraction Library et souvent
écrit GDAL/OGR, est un logiciel libre qui ouvre des données
cartographiques stockées dans un format et les écrit dans un autre,
en les reprojetant au passage si on le lui demande. Sa documentation
le présente comme une bibliothèque de conversion.

Les données spatiales prennent deux formes. Les données raster sont
une grille de cellules : une image satellite, une photographie
aérienne, un modèle altimétrique. Les données vectorielles sont des
points, lignes et polygones accompagnés d'attributs : adresses,
routes, limites parcellaires. GDAL fournit au programme qui
l'appelle un modèle abstrait pour chacune de ces formes ; derrière
ce modèle se trouve un pilote par format. GeoTIFF, JPEG 2000 et
NetCDF ont leurs pilotes côté raster ; Shapefile, GeoJSON,
GeoPackage, KML et les tables PostgreSQL ont les leurs côté
vectoriel. Il en existe bien d'autres dans chaque catégorie. Un
programme utilisant GDAL les lit tous par les mêmes appels.

La moitié vectorielle s'est appelée OGR pendant des années. Les deux
moitiés ont conservé des structures de pilotes distinctes jusqu'à
leur fusion dans GDAL 2.0. C'est pourquoi les programmes vectoriels
portent toujours cet ancien préfixe : `ogrinfo` décrit un jeu de
données vectorielles, et `ogr2ogr` le convertit. Frank Warmerdam a
commencé à travailler sur la bibliothèque fin 1998. Elle est publiée
sous une licence de type MIT et fait partie des projets de l'Open
Source Geospatial Foundation, OSGeo.

Il existe trois façons de l'utiliser. La première est la ligne de
commande, avec des programmes comme `gdalinfo`, `gdal_translate` et
`gdalwarp` pour les rasters, `ogrinfo` et `ogr2ogr` pour les données
vectorielles. Depuis la version

3.11, il existe aussi une commande unique `gdal` avec des
sous-commandes comme `gdal raster` et `gdal vector`, encore
qualifiée de provisoire par le projet. La deuxième passe par le
code, grâce aux liaisons pour Python et d'autres langages. La
troisième passe par d'autres logiciels : QGIS, par exemple, lit ses
formats vectoriels à travers les pilotes GDAL et propose les
programmes GDAL dans sa boîte à outils de traitements. Une
conversion typique tient en une ligne : ici, un shapefile devient un
GeoPackage et est reprojeté dans la zone UTM utilisée dans tout le
Danemark :

```sh
ogr2ogr -f GPKG -t_srs EPSG:25832 parcels.gpkg parcels.shp
```

À la date de rédaction, la version courante est la 3.13.3. Peu
d'outils sont en concurrence à ce niveau. ArcGIS dispose de ses
propres outils de conversion, et certains formats ont leurs lecteurs
légers dédiés. Mais une équipe qui doit accepter ce que lui envoie
un client finit souvent par intégrer GDAL à son système, parfois à
travers une bibliothèque qui en dépend.

Pourquoi c'est important

Tout système géospatial a une frontière par laquelle entrent les
données extérieures : shapefiles d'une commune, GeoTIFF d'un
géomètre, export GeoJSON d'un partenaire, fichier KML dessiné dans
un navigateur. GDAL intervient dans le choix de ce qui assure ce
passage : une personne cliquant dans un logiciel de bureau ou un
script répétant les mêmes opérations à chaque livraison. GDAL rend
ce script peu coûteux à écrire.

Une conversion formulée comme une commande `ogr2ogr` ou `gdalwarp`
peut être relue, conservée dans le gestionnaire de versions et
réexécutée à la livraison suivante. Une conversion manuelle est
faite une fois, par la personne qui se souvient des étapes. Pour des
données livrées par lots, mois après mois, cette différence
détermine si la qualité se maintient.

La licence compte aussi. Il n'y a ni redevance par poste ni
autorisation d'un fournisseur à obtenir. Le même outil fonctionne
sur un ordinateur portable, un serveur de compilation et dans un
conteneur.

La troisième raison est l'accès au stockage. Les systèmes de
fichiers virtuels de GDAL permettent à un pilote de lire les données
là où elles se trouvent. Avec le préfixe `/vsicurl/`, il lit un
fichier par HTTP en demandant des plages d'octets : la plupart des
pilotes consomment ainsi un jeu de données distant morceau par
morceau sans le télécharger entièrement. `/vsis3/` fait de même sur
Amazon S3. Ajoutez un Cloud Optimized GeoTIFF, découpé en tuiles,
contenant ses propres vues réduites et organisé pour limiter le
nombre de requêtes : un raster de plusieurs gigaoctets peut rester
dans un stockage objet et être lu fenêtre par fenêtre.

Les coûts sont réels eux aussi. GDAL est une grande bibliothèque
native avec de nombreuses dépendances facultatives. Les pilotes
présents dépendent de sa compilation : deux machines qui « ont
GDAL » peuvent ouvrir des formats différents. Et sa conversion
fidèle transmet tout aussi fidèlement les limites du format de
sortie demandé.

À quoi cela ressemble en pratique

GDAL apparaît dans deux projets de ce site, avec deux rôles
différents.

De 2015 à 2022, dans ses fonctions de responsable d'équipe de
développement logiciel SIG, la fondatrice a assuré la livraison de
plus de trente projets SIG, chacun accompagné en production après sa
livraison. Ils reposaient sur PostgreSQL avec PostGIS pour les
données spatiales. GDAL/OGR servait à transférer ces données entre
formats : shapefiles, GeoJSON, GeoTIFF, KML et tuiles vectorielles.
QGIS et JOSM servaient au travail sur les données elles-mêmes, et
les cartes étaient construites avec Mapbox GL et Leaflet. Les deux
moitiés de la bibliothèque étaient utilisées, puisque GeoTIFF est
raster et les autres formats de cette liste sont vectoriels. Les
projets allaient de la cartographie numérique 2D et 3D et du
traitement LiDAR à la géorectification, à la vectorisation, à la
cartographie intérieure et à la navigation.

De 2022 à 2024, alors que la fondatrice occupait un poste
d'ingénieure données sur un projet d'analyse géospatiale à grande
échelle, GDAL faisait partie des outils de détection et de
correction des erreurs. Les erreurs spatiales étaient diagnostiquées
et corrigées avec GDAL, QGIS et ArcGIS. Comme les mêmes nettoyages
revenaient, ils ont été automatisés par des scripts Bash. PostGIS
assurait les requêtes et les index spatiaux ; des procédures en
PL/pgSQL et Transact-SQL transformaient les données dans PostgreSQL
et SQL Server. Les données nettoyées alimentaient des visualisations
interactives réalisées avec Mapbox. Avec GDAL parmi les outils, le
nettoyage a résolu plus de 1 000 problèmes et a contribué à la
réduction de 35 % des temps d'exécution des requêtes spatiales.

Où les problèmes surviennent

GDAL fait exactement ce qu'on lui demande. La plupart des
difficultés commencent lorsque la demande diffère légèrement de
l'intention.

Les points arrivent sur le mauvais continent. Depuis GDAL 3.0, la
bibliothèque respecte l'ordre des axes fixé par l'autorité qui
définit le système de coordonnées. Pour EPSG:4326, le système
familier de latitude et longitude, la latitude vient en premier. Le
code écrit pour GDAL 2 passe la longitude d'abord, tout comme
GeoJSON. Mélangez les deux, et chaque paire est inversée : un point
de Copenhague réapparaît dans la mer d'Arabie. Choisissez un ordre à
la frontière du programme et explicitez-le. Pour le code qui veut la
longitude en premier, le réglage documenté est
`SetAxisMappingStrategy(OAMS_TRADITIONAL_GIS_ORDER)` sur la
référence spatiale.

Les noms de colonnes sont tronqués et les dates perdent l'heure. Un
shapefile limite les noms d'attributs à 10 caractères. GDAL
raccourcit les noms plus longs à l'écriture. Si deux noms raccourcis
entrent en collision, il les réduit à

8 caractères et ajoute un numéro de séquence : `abcdefghijkl`
devient `abcdefgh_1`. Le format stocke les dates sans heure. GDAL
recommande de garder les fichiers `.shp` et `.dbf` à 2 Go ou moins
pour l'interopérabilité avec d'autres logiciels. Le texte danois ou
cyrillique peut devenir illisible si son encodage est mal identifié
en l'absence du fichier `.cpg` qui indique la page de codes. Écrivez
du GeoPackage lorsque le destinataire l'accepte. Si un shapefile est
exigé, renommez délibérément les colonnes avant la conversion.

Un raster distant est téléchargé en entier. Avec une simple adresse
`https://` sans préfixe, GDAL choisit son pseudo-pilote HTTP, qui
charge tout le fichier en mémoire avant qu'un pilote ne le lise.
Cela convient à un petit fichier, mais pas à une orthophotographie
nationale. Préfixez l'adresse par `/vsicurl/` pour ne récupérer que
les plages d'octets nécessaires, et stockez les gros rasters en
Cloud Optimized GeoTIFF pour réduire le nombre de ces plages. Puis
laissez le fichier intact : modifier un COG sur place casse son
organisation. Depuis GDAL 3.8, son ouverture en modification est
refusée, sauf si cette altération est explicitement autorisée.

Les nombres d'un CSV arrivent sous forme de texte. Le pilote CSV lit
chaque champ comme une chaîne, sauf instruction contraire. Une
colonne de populations se trie donc alphabétiquement, et une somme
en aval provoque une erreur de type. Définissez l'option d'ouverture
`AUTODETECT_TYPE=YES`, ou livrez à côté du CSV un fichier `.csvt`
qui précise le type de chaque colonne.

Une mise à niveau casse l'import Python. Le paquet `gdal` sur PyPI
est compilé avec la bibliothèque GDAL déjà installée sur la
machine : les deux versions doivent donc correspondre. Les consignes
d'installation du projet les alignent :

```sh
pip install gdal[numpy]=="$(gdal-config --version).*"
```

Pour aller plus loin

  * Documentation GDAL — la présentation par le projet de sa
bibliothèque de conversion, de ses pilotes et de sa licence.

  * Programmes — tous les outils en ligne de commande, de `gdalinfo`
et `ogr2ogr` à la nouvelle commande `gdal`.

  * Systèmes de fichiers virtuels GDAL — `/vsicurl/`, `/vsis3/` et
les autres préfixes pour lire les données sur place.

  * Tutoriel OGR sur les systèmes de référence de coordonnées et la
transformation de coordonnées — notamment l'ordre des axes et les
changements de GDAL 3.0.

  * COG : générateur de Cloud Optimized GeoTIFF — l'organisation du
fichier, ses vues réduites et les raisons pour lesquelles une
modification sur place les compromet.

hCette page sur le Web	URL:https://engineer.company/fr/glossary/gdal/	engineer.company	70
