# 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](/fr/portfolio/led-30-gis-projects-from-build-to-support/).
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](/fr/portfolio/resolved-1000-issues-in-geographical-data/).
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](https://gdal.org/en/stable/) — la présentation par le
  projet de sa bibliothèque de conversion, de ses pilotes et de sa licence.
- [Programmes](https://gdal.org/en/stable/programs/index.html) — tous les outils
  en ligne de commande, de `gdalinfo` et `ogr2ogr` à la nouvelle commande `gdal`.
- [Systèmes de fichiers virtuels GDAL](https://gdal.org/en/stable/user/virtual_file_systems.html)
  — `/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](https://gdal.org/en/stable/tutorials/osr_api_tut.html)
  — notamment l'ordre des axes et les changements de GDAL 3.0.
- [COG : générateur de Cloud Optimized GeoTIFF](https://gdal.org/en/stable/drivers/raster/cog.html)
  — l'organisation du fichier, ses vues réduites et les raisons pour lesquelles
  une modification sur place les compromet.

<https://engineer.company/fr/glossary/gdal/>
