add(article): Principes et fonctionnement de la nouvelle CLI GDAL. Enfin. by thomas-szczurek · Pull Request #1441 · geotribu/website

thomas-szczurek · 2026-03-12T14:48:31Z

add(article): Principes et fonctionnement de la nouvelle CLI GDAL. Enfin.

ℹ️ Message automatique à lire et remplir ⬇️

Important

Rappel : votre contribution doit émaner de votre originalité, et non découler d'un copier / coller issu d'un prompt.

j'ai connaissance de la ligne et de la charte éditoriales de Geotribu et je garantis que ma contribution est conforme, notamment avec les lignes directrices concernant l'usage de l'IA pour les contributions à Geotribu.

Liens importants

pour modifier ton article via l'interface de GitHub, tu peux le retrouver facilement via l'icône crayon en haut de la page sur le site de prévisualisation (cf. documentation). Sinon :
- article
- page auteur/ice
le dossier dédié pour les illustrations de l'article sur notre "CDN" : https://cdn.geotribu.fr/tinyfilemanager.php. Si besoin des accès, contacter en message privé (Mastodon, mail, Matrix,...)
site temporaire de prévisualisation de l'article - merci de ne pas le diffuser

Ressources

Pour info, voici quelques extraits de notre guide de contribution :

📢 Diffusion

Une fois l'article publié, il sera alors temps de le diffuser. Il sera automatiquement intégré au flux RSS et à la newsletter.

Mais la publication sur les réseaux sociaux est manuelle.

Nous avons des comptes officiels sur ces réseaux sociaux :

BlueSky
~~Facebook - inactif~~
LinkedIn avec le hashtag #Geotribu
Mastodon
~~X/Twitter~~ - inactif

Merci d'indiquer en commentaire tes comptes à utiliser pour être cité/e dans les messages et de cocher ci-après la "stratégie" de diffusion qui te convient pour chaque réseau.

BlueSky

un/e membre de Geotribu publie, tu repartages avec ton compte
tu publies, on repartage
chacun/e publie de son côté
je souhaite que mon contenu ne soit pas diffusé sur ce réseau

LinkedIn

un/e membre de Geotribu publie, tu repartages avec ton compte
tu publies, on repartage
chacun/e publie de son côté
je souhaite que mon contenu ne soit pas diffusé sur ce réseau

Mastodon

un/e membre de Geotribu publie, tu repartages avec ton compte
tu publies, on repartage
chacun/e publie de son côté
je souhaite que mon contenu ne soit pas diffusé sur ce réseau

Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

thomas-szczurek

Suppression d'une blague hors contecte 6 mois après

Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

gounux

Merci Thomas, ça fait plaisir de te revoir ici, sympa l'article !

Quelques corrections de coquilles, est-ce que l'article mériterait pas quelques images ?

Co-authored-by: Guilhem Allaman <40383801+gounux@users.noreply.github.com> Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

thomas-szczurek · 2026-03-16T16:25:40Z

Merci Thomas, ça fait plaisir de te revoir ici, sympa l'article !

Quelques corrections de coquilles, est-ce que l'article mériterait pas quelques images ?

Merci ! En soit, je me le suis bien dis pour les images, mais est-ce bien sage d'illustrer des lignes de commande par des screenshots de lignes de commande ?

Co-authored-by: Guilhem Allaman <40383801+gounux@users.noreply.github.com> Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

Co-authored-by: Guilhem Allaman <40383801+gounux@users.noreply.github.com> Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

thomas-szczurek

Tags ajoutés et phrase compliquée racourcie

Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

Guts · 2026-03-24T19:51:28Z

Allez zou, c'est parti pour la @geotribu/relecture !

ℹ️ Aux relecteur/ices

Merci d'utiliser autant que possible le mode Suggestion de la review : https://docs.github.com/fr/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request#starting-a-review

C'est vraiment IMPORTANT pour le confort de l'auteur/ice 🙏

gounux

Après un long silence, une petite review principalement sur quelques coquilles et de la forme,

est-ce bien sage d'illustrer des lignes de commande par des screenshots de lignes de commande ?

Sage comme une image ?
C'est vrai qu'illustrer une CLI, bon voilà... C'est bien aussi comme ça avec les nombreux exemples fournis :)
Merci @thomas-szczurek !

gounux · 2026-04-11T06:20:12Z

+
+Maitriser `GDAL`, c'est être capable de remplacer des ~~interfaces graphiques~~ logiciels coutant des dizaines de milliers d'euros.
+
+Cependant, historiquement les programmes `GDAL` étaient ... comment dire ... peut normés entre eux, par exemple `gdal_translate` (le programme servant aux conversions raster) demandait ses fichiers d'entrée / sortie dans cet ordre : in -> out alors qu'`ogr2ogr` (le programme servant aux conversions vecteur) lui demandait : out -> in. De plus les plus gros programmes, ceux qui "faisaient tout" on été supprimés et remplacés par des équivalents plus spécifiques.


Suggested change

Cependant, historiquement les programmes `GDAL` étaient ... comment dire ... peut normés entre eux, par exemple `gdal_translate` (le programme servant aux conversions raster) demandait ses fichiers d'entrée / sortie dans cet ordre : in -> out alors qu'`ogr2ogr` (le programme servant aux conversions vecteur) lui demandait : out -> in. De plus les plus gros programmes, ceux qui "faisaient tout" on été supprimés et remplacés par des équivalents plus spécifiques.

Cependant, historiquement les programmes `GDAL` étaient... comment dire... peu normés entre eux, par exemple `gdal_translate` (le programme servant aux conversions raster) demandait ses fichiers d'entrée / sortie dans cet ordre : in -> out alors qu'`ogr2ogr` (le programme servant aux conversions vecteur) lui demandait : out -> in. De plus les plus gros programmes, ceux qui "faisaient tout" ont été supprimés et remplacés par des équivalents plus spécifiques.

on été supprimés et remplacés par des équivalents plus spécifiques.

A reformuler car prête à confusion avec la phrase suivante qui dit qu'ils sont toujours dispos

gounux · 2026-04-11T06:30:13Z

+Ensuite, c'est simple, ils s'appellent comme ceci :
+
+```python
+gdal.Run("vector"/"raster"/"vsi", "programme", option(s), input="in.tif", output="out.tif)


Suggested change

gdal.Run("vector"/"raster"/"vsi", "programme", option(s), input="in.tif", output="out.tif)

gdal.Run("vector", "programme", option(s), input="in.tif", output="out.tif")

gdal.Run("raster", "programme", option(s), input="in.tif", output="out.tif")

gdal.Run("vsi", "programme", option(s), input="in.tif", output="out.tif")

Au début j'ai buggué, j'ai cru que c'était une nouvelle syntaxe python 3.17...

Peut-être plus simple à comprendre, je sais pas, à voir aussi si besoin de changer les extensions, vector notamment,

Guts · 2026-04-12T15:33:38Z

Merci Guilhem pour la relecture.

Est-ce qu'on demanderait pas à @rouault ce qu'il pense de ce contenu :) ?

rouault

Merci pour cette intro à la nouvelle interface en ligne de commande!

A voir si vous voulez le mentionnez, mais au cas où, ça fera l'objet d'un atelier dédié de 4h (en anglais) lors de la conférence FOSS4G-Europe 2026 : https://talks.osgeo.org/foss4g-europe-2026-workshops/talk/PR7HNK/ .

rouault · 2026-04-12T15:41:55Z

+
+Maitriser `GDAL`, c'est être capable de remplacer des ~~interfaces graphiques~~ logiciels coutant des dizaines de milliers d'euros.
+
+Cependant, historiquement les programmes `GDAL` étaient ... comment dire ... peut normés entre eux, par exemple `gdal_translate` (le programme servant aux conversions raster) demandait ses fichiers d'entrée / sortie dans cet ordre : in -> out alors qu'`ogr2ogr` (le programme servant aux conversions vecteur) lui demandait : out -> in. De plus les plus gros programmes, ceux qui "faisaient tout" on été supprimés et remplacés par des équivalents plus spécifiques.


on été supprimés et remplacés par des équivalents plus spécifiques.

A reformuler car prête à confusion avec la phrase suivante qui dit qu'ils sont toujours dispos

rouault · 2026-04-12T15:46:40Z

+gdal vector convert --append in.shp PG:"dbname='my_db' user='me' password='admin123' schemas='my_schema'"
+```
+
+Une différence par rapport à l'ancienne CLI est l'obligation de l'utilisation de l'option `append`, même pour créer une table non existante.


On a du corrigé ça depuis la 3.11, car --append non nécessaire avec 3.12 quand la table n'existe pas.

rouault · 2026-04-12T15:49:16Z

+On peut s'en servir pour créer des [Cloud Optimized Geotiff](https://guide.cloudnativegeo.org/cloud-optimized-geotiffs/intro.html). Voir cet [article de geotribu par Nicolas Rochard](https://geotribu.fr/articles/2025/2025-02-11_bonnes-pratiques-generation-raster-cog-avec-gdal/) pour les options qui sont utilisées par la région Hauts de France.
+
+```sh
+gdal raster convert --ouput-format=COG -co COMPRESS=ZSTD -co BIGTIFF=IF_NEEDED in.tif out.tif


BIGTIFF=IF_NEEDED est la valeur par défaut et manque d'un 2ème trait d'union devant -co

Suggested change

gdal raster convert --ouput-format=COG -co COMPRESS=ZSTD -co BIGTIFF=IF_NEEDED in.tif out.tif

gdal raster convert --ouput-format=COG --co COMPRESS=ZSTD in.tif out.tif

rouault · 2026-04-12T15:57:45Z

+
+Chaque programme `GDAL` est implémenté sous forme d'instances de la classe `osgeo.gdal.Algorithm`, qu'on appelle en utilisant la méthode `osgeo.gdal.Run()` ou plutôt `gdal.Run()` si on a importé `GDAL` comme dans l'exemple ci-dessus.
+
+Ensuite, c'est simple, ils s'appellent comme ceci :


la syntaxe gdal.alg.x.y(...) ajoutée GDAL 3.12 (cf https://gdal.org/en/stable/programs/gdal_cli_from_python.html#gdal-alg-module) est encore plus sympa, et bénéficie de docstring avec les paramètres disponibles et donc d'auto-complétion/suggestion dans votre IDE favori

rouault · 2026-04-12T16:25:20Z

mais est-ce bien sage d'illustrer des lignes de commande par des screenshots de lignes de commande ?

Dans la doc de GDAL 3.13, on a osé pour illustrer les pipelines complexes. Cf https://gdal.org/en/latest/programs/gdal_pipeline.html#programs/gdal_pipeline-5 ( généré grace à https://github.com/geographika/gdalgviz )

Ne reste plus que les commentaires nécessitant modification du corps de texte en lui mêmê Co-authored-by: Guilhem Allaman <40383801+gounux@users.noreply.github.com> Co-authored-by: Even Rouault <even.rouault@spatialys.com> Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

Guts · 2026-04-15T09:35:19Z

@thomas-szczurek Il va te falloir changer la date et donc renommer le fichier. Quand souhaites-tu publier l'article ?

Sachant que demain il y a la partie 1 sur Mapproxy et la partie 2 en fin de mois. Sauf si tu es pressé, je te conseillerais plutôt d'attendre jusqu'au 12 mai pour éviter qu'il soit pris en sandwich entre 2 Mapproxy ou dans la huitaine de ponts de mai, mais inclus dans la prochaine RDP. Dis-nous !

⚠️ il faut que tu acceptes d'abord les modifs / suggestion des reviewers avant de renommer sinon GH est perdu. ⚠️

Guts · 2026-04-15T13:28:29Z

@thomas-szczurek j'avais oublié d'éditer la description de ta PR avec notre modèle. Je te laisse cocher ce qui est te va bien :).

…-szczurek

…-szczurek Signed-off-by: Julien <1596222+Guts@users.noreply.github.com>

github-actions · 2026-04-15T16:16:08Z

🎉 Le site de prévisualisation pour cette PR a été généré et est disponible sous ce lien.
Commit de référence : 8023200.

Add files via upload

f53e4c9

Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

github-actions bot added the articles Tutoriels, actualité, billet... label Mar 12, 2026

[pre-commit.ci] Corrections automatiques appliquées par les git hooks.

45194d1

thomas-szczurek changed the title ~~Ajout article sur la nouvelle CLI gdal~~ add(article): Principes et fonctionnement de la nouvelle CLI GDAL. Enfin. Mar 12, 2026

thomas-szczurek commented Mar 14, 2026

View reviewed changes

Comment thread content/articles/2026/2026-03-23_nouvelle_cli_gdal.md Outdated

Update content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

3ac7b93

Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

thomas-szczurek commented Mar 14, 2026

View reviewed changes

Comment thread content/articles/2026/2026-03-23_nouvelle_cli_gdal.md Outdated

thomas-szczurek and others added 2 commits March 14, 2026 16:37

Update content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

a62d881

Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

[pre-commit.ci] Corrections automatiques appliquées par les git hooks.

ab87170

gounux reviewed Mar 15, 2026

View reviewed changes

Update content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

6781f76

Co-authored-by: Guilhem Allaman <40383801+gounux@users.noreply.github.com> Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

thomas-szczurek and others added 4 commits March 16, 2026 17:25

Update content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

06960e6

Co-authored-by: Guilhem Allaman <40383801+gounux@users.noreply.github.com> Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

Update content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

4ed392f

Co-authored-by: Guilhem Allaman <40383801+gounux@users.noreply.github.com> Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

Update content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

f69ac71

Co-authored-by: Guilhem Allaman <40383801+gounux@users.noreply.github.com> Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

Update content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

05d5660

Co-authored-by: Guilhem Allaman <40383801+gounux@users.noreply.github.com> Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

thomas-szczurek commented Mar 16, 2026

View reviewed changes

Comment thread content/articles/2026/2026-03-23_nouvelle_cli_gdal.md Outdated

thomas-szczurek and others added 2 commits March 16, 2026 17:28

Update content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

268fbe7

Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

Update content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

0dc10ad

Co-authored-by: Guilhem Allaman <40383801+gounux@users.noreply.github.com> Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

thomas-szczurek commented Mar 24, 2026

View reviewed changes

Comment thread content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

Comment thread content/articles/2026/2026-03-23_nouvelle_cli_gdal.md Outdated

thomas-szczurek and others added 3 commits March 24, 2026 17:47

Update content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

d97775f

Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

Update content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

4e845ec

Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

[pre-commit.ci] Corrections automatiques appliquées par les git hooks.

a5b3391

thomas-szczurek commented Mar 24, 2026

View reviewed changes

Comment thread content/articles/2026/2026-03-23_nouvelle_cli_gdal.md Outdated

Update content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

466e03a

Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

thomas-szczurek commented Mar 24, 2026

View reviewed changes

Comment thread content/articles/2026/2026-03-23_nouvelle_cli_gdal.md Outdated

Update content/articles/2026/2026-03-23_nouvelle_cli_gdal.md

7714b11

Signed-off-by: thomas-szczurek <121474664+thomas-szczurek@users.noreply.github.com>

Guts requested review from a team and jeremieprudhomme and removed request for a team March 24, 2026 19:50

Guts requested a review from lbartoletti March 24, 2026 19:50

gounux reviewed Apr 11, 2026

View reviewed changes

Merge branch 'master' into master

51abd19

Guts assigned thomas-szczurek Apr 12, 2026

rouault reviewed Apr 12, 2026

View reviewed changes

fix(author): correction syntaxe compte Linkedin de la page de @thomas…

8023200

…-szczurek Signed-off-by: Julien <1596222+Guts@users.noreply.github.com>

github-actions bot added the contributeurices Contenus liés à la contribution et contributeur/ices : biographies, à propos, etc. label Apr 15, 2026


		Maitriser `GDAL`, c'est être capable de remplacer des ~~interfaces graphiques~~ logiciels coutant des dizaines de milliers d'euros.

		Cependant, historiquement les programmes `GDAL` étaient ... comment dire ... peut normés entre eux, par exemple `gdal_translate` (le programme servant aux conversions raster) demandait ses fichiers d'entrée / sortie dans cet ordre : in -> out alors qu'`ogr2ogr` (le programme servant aux conversions vecteur) lui demandait : out -> in. De plus les plus gros programmes, ceux qui "faisaient tout" on été supprimés et remplacés par des équivalents plus spécifiques.

-gdal.Run("vector"/"raster"/"vsi", "programme", option(s), input="in.tif", output="out.tif)
+gdal.Run("vector", "programme", option(s), input="in.tif", output="out.tif")
+gdal.Run("raster", "programme", option(s), input="in.tif", output="out.tif")
+gdal.Run("vsi", "programme", option(s), input="in.tif", output="out.tif")

	gdal raster convert --ouput-format=COG -co COMPRESS=ZSTD -co BIGTIFF=IF_NEEDED in.tif out.tif
	gdal raster convert --ouput-format=COG --co COMPRESS=ZSTD in.tif out.tif


		Chaque programme `GDAL` est implémenté sous forme d'instances de la classe `osgeo.gdal.Algorithm`, qu'on appelle en utilisant la méthode `osgeo.gdal.Run()` ou plutôt `gdal.Run()` si on a importé `GDAL` comme dans l'exemple ci-dessus.

		Ensuite, c'est simple, ils s'appellent comme ceci :

Uh oh!

Conversation

thomas-szczurek commented Mar 12, 2026 • edited by Guts Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Liens importants

Ressources

📢 Diffusion

BlueSky

LinkedIn

Mastodon

Uh oh!

thomas-szczurek left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

gounux left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

thomas-szczurek commented Mar 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

thomas-szczurek left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Guts commented Mar 24, 2026

Uh oh!

gounux left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gounux Apr 11, 2026

Choose a reason for hiding this comment

Uh oh!

rouault Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gounux Apr 11, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Guts commented Apr 12, 2026

Uh oh!

rouault left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

rouault Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

rouault Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

rouault Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

rouault Apr 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

thomas-szczurek commented Mar 12, 2026 •

edited by Guts

Loading

gounux left a comment •

edited

Loading

thomas-szczurek commented Mar 16, 2026 •

edited

Loading

gounux left a comment •

edited

Loading

rouault Apr 12, 2026 •

edited

Loading