GDAL-PIPELINE(1) GDAL GDAL-PIPELINE(1) (NAME) gdal-pipeline - 3.12 . (DESCRIPTION) gdal pipeline (pipeline) . (features) (on-demand) "" (materialize) . gdal raster materialize gdal vector materialize . (SYNOPSIS) : gdal pipeline [OPTIONS] . Positional arguments: Common Options: -h, --help --json-usage JSON --config = [ ] -q, --quiet ( ) [ ] Advanced Options: --= : read|calc|concat|create|mosaic|stack [READ-OPTIONS] ( ! [STEP-OPTIONS] )* ! write!info!tile [WRITE-OPTIONS] ! ( ) . ! gdal pipeline . read calc concat mosaic stack info tile write . . read calc concat mosaic stack info tile partition write . : (footprint) (buffer) $ gdal pipeline ! read in.tif ! footprint ! buffer 20 ! write out.gpkg --overwrite (STEPS) raster gdal raster pipeline . vector gdal vector pipeline . . +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------+ | | | +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------+ |contour | | | | | +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------+ |footprint | | | | | +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------+ |pixel-info | | | | | +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------+ |polygonize | | | | | +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------+ |grid | | | | | +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------+ |rasterize | | | | | +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------+ |tee | | | | | |contour | | |0.0 | | |3.5 | | | | | |* contour [OPTIONS] | | |------------------- | | | | | | (DEM). | | | | | |: | | | --output-layer | | | -b, --band ( ) (: 1) | | | --elevation-name | | | --min-name | | | --max-name | | | --3d | | | --input-nodata 'nodata' | | | --interval | | | --levels --exp-base | | | --levels [] | | | --interval --exp-base | | | -e, --exp-base | | | --interval --levels | | | --off, --offset | | | -p, --polygonize | | | --group-transactions n (: 100 000) | | | | | | | | |168u | | | | | |168u | | | gdal raster contour . | | |footprint | | |0.0 | | |3.5 | | | | | |* footprint [OPTIONS] | | |--------------------- | | | | | | (footprint) . | | | | | |: | | | --output-layer (: footprint) | | | -b, --band () ( ) [] | | | --combine-bands .. COMBINE-BANDS=union|intersection (: union) | | | --overview (overview) | | | --input-nodata | | | --input-nodata nodata . [.. ] | | | --overview | | | --coordinate-system . COORDINATE-SYSTEM=georeferenced|pixel | | | --output-crs (CRS) | | | --split-multipolygons (multipolygons) | | | --convex-hull (convex hull) | | | --densify-distance . | | | --simplify-tolerance . | | | --min-ring-area (ring) | | | --max-points (: 100) | | | --location-field . (: location) | | | --no-location-field | | | --no-location-field | | | --location-field | | | --absolute-path | | | | | | | | |168u | | | | | |168u | | | gdal raster footprint . | | |grid | | |0.0 | | |3.5 | | | | | |* grid [OPTIONS] | | |-------------------------- | | | | | | : | | | - average: . | | | - average-distance: ( ) . | | | - average-distance-points: . | | | - count: . | | | - invdist: (IDW). | | | - invdistnn: . | | | - linear: / (barycentric). | | | - maximum: . | | | - minimum: . | | | - nearest: . | | | - range: . | | | | | | | | |168u | | | | | |168u | | | gdal vector grid . | | |pixel-info | | |0.0 | | |3.5 | | | | | |* pixel-info [OPTIONS] [] | | |--------------------------------------------------- | | | | | | . | | | | | | : | | | -i, --dataset, --input [] | | | --position-dataset | | | --position | | | | | |: | | | -l, --layer, --input-layer | | | -b, --band () ( ) [] | | | --overview (overview) | | | -p, --pos, --position or [] | | | --position-dataset | | | --position-crs (CRS) ( 'position-dataset' 'pixel' ) | | | -r, --resampling . RESAMPLING=nearest|bilinear|cubic|cubicspline (: nearest) | | | --promote-pixel-value-to-z Z GeoJSON | | | --include-field ( : ALL NONE) (: ALL) [] | | | | | | | | |168u | | | | | |168u | | | gdal raster pixel-info ..SS polygonize | | |0.0 | | |3.5 | | | | | |* polygonize [OPTIONS] | | |---------------------- | | | | | | . | | | | | |: | | | --output-layer | | | -b, --band ( ) (: 1) | | | --attribute-name (: DN) | | | -c, --connect-diagonal-pixels | | | | | | | | |168u | | | | | |168u | | | gdal raster polygonize . | | |rasterize | | |0.0 | | |3.5 | | | | | |* rasterize [OPTIONS] | | |--------------------- | | | | | | (burn) . | | | | | |: | | | -b, --band () ( ) [ ] | | | --invert | | | --all-touched ALL_TOUCHED | | | --burn (burn) [ ] | | | -a, --attribute-name | | | --3d Z | | | -l, --input-layer | | | --sql | | | --where where SQL | | | --sql select SQL | | | --input-layer | | | --dialect SQL | | | --nodata nodata | | | --init [ ] | | | --crs | | | --transformer-option = transformer GDALCreateGenImgProjTransformer2 [ ] | | | --extent ,,, [ ] | | | --resolution , [ ] | | | --size | | | --tap, --target-aligned-pixels ( ) | | | --resolution | | | --size , [ ] | | | --resolution | | | --ot, --datatype, --output-data-type . OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 | | | --optimization ( ). OPTIMIZATION=AUTO|RASTER|VECTOR (: AUTO) | | | | | | | | |168u | | | | | |168u | | | gdal vector rasterize . | | |tee | | |0.0 | | |3.5 | | | | | |* tee [OPTIONS] [...] | | |------------------------------- | | | | | | . | | | | | | : | | | --tee-pipeline [.. ] | | | | | | | | |168u | | | | | |168u | | | Output nested pipeline . | | |" GDALG ( / ) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" | | | GDALG JSON . | | | GDALG: GDAL Streamed Algorithm GDALG: GDAL Streamed Algorithm (on-the-fly) (streamed) . | | | command_line JSON write | | |gdal pipeline ! .... ! write out.gdalg.json | | | . | | |0.0 | | |3.5 | | | | | |{ | | | "type": "gdal_streamed_alg", | | | "command_line": "gdal pipeline ! read in.tif ! footprint ! buffer 20" | | |} | | | | | | | | |168u | | | | | |168u | | | write stream . | | |0.0 | | |3.5 | | | | | |{ | | | "type": "gdal_streamed_alg", | | | "command_line": "gdal pipeline ! read in.tif ! footprint ! buffer 20 ! write --output-format=streamed streamed_dataset" | | |} | | | | | | | | |168u | | | | | |168u | | |" (SUBSTITUTIONS)" | | | gdal pipeline .gdalg.json / . | | | (syntax) : | | |0.0 | | |3.5 | | | | | |gdal pipeline --.=value | | | | | | | | |168u | | | | | |168u | | | gdal pipeline . | | | raster_reproject.gdalg.json : | | |0.0 | | |3.5 | | | | | |{ | | | "type": "gdal_streamed_alg", | | | "command_line": "gdal pipeline ! read in.tif ! reproject --output-crs=EPSG:4326 ! edit --metadata=CHANGES=reprojected" | | |} | | | | | | | | |168u | | | | | |168u | | | input read write output . | | |0.0 | | |3.5 | | | | | |$ gdal pipeline raster_reproject.gdalg.json --read.input=other_input.tif --write.output=out.tif | | | | | | | | |168u | | | | | |168u | | | ( gdal pipeline ): | | |0.0 | | |3.5 | | | | | |$ gdal pipeline raster_reproject.gdalg.json --input=other_input.tif --output=out.tif --co COMPRESS=LZW --overwrite | | | | | | | | |168u | | | | | |168u | | | [] . | | | : | | |0.0 | | |3.5 | | | | | |{ | | | "type": "gdal_streamed_alg", | | | "command_line": "gdal pipeline ! read in.tif ! edit --metadata=before=value ! reproject --output-crs=EPSG:4326 ! edit --metadata=CHANGES=reprojected" | | |} | | | | | | | | |168u | | | | | |168u | | | : | | |0.0 | | |3.5 | | | | | |$ gdal pipeline raster_reproject.gdalg.json --edit[0].metadata=before=modified --output=out.tif | | | | | | | | |168u | | | | | |168u | | | Python : | | |0.0 | | |3.5 | | | | | |gdal.Run("pipeline", pipeline="raster_reproject.gdalg.json", output="out.tif", arguments={"edit[0].metadata": "before=modified"}) | | | | | | | | |168u | | |" _PIPE_ (PLACEHOLDER DATASET NAME _PIPE_)" | | | 3.13 . | | | | | | (pipeline) input . (pipe) . | | | _PIPE_ ( PIPE ) . | | |" : " | | |0.0 | | |3.5 | | | | | |gdal pipeline read points.geojson ! buffer 200 ! \ | | | zonal-stats \ | | | --input dem.tif | | | --zones _PIPE_ \ | | | --stat mean ! \ | | | write \ | | | --output-format CSV \ | | | --output /vsistdout/ | | | | | | | | |168u | | | | | |168u | | | . | | |" (NESTED PIPELINE)" | | | " " ( ) . | | | ([ ]) (space) . | | | : | | |0.0 | | |o 2 | | | (input nested pipelines): . | | |o 2 | | | (output nested pipelines): . tee . | | | | | |168u | | |" " | | | . info tile write . | | |" : DEM " | | |0.0 | | |3.5 | | | | | |$ gdal pipeline read n43.tif ! \ | | | color-map --color-map color_file.txt ! \ | | | blend --operator=hsv-value --overlay \ | | | [ read n43.tif ! hillshade -z 30 ] ! \ | | | write out.tif --overwrite | | | | | | | | |168u | | | | | |168u | | | overlay blend read n43.tif ! hillshade -z 30 . | | |[] | | |" " | | | tee . tee read calc concat mosaic stack write tile . tee . | | | tee . | | |" : "cities" " | | |0.0 | | |3.5 | | | | | |$ gdal pipeline read cities.gpkg ! \ | | | tee [ filter --where "pop < 1e6" ! write small_cities.gpkg ] \ | | | [ filter --where "pop >= 1e6" ! write big_cities.gpkg ] | | | | | | | | |168u | | | | | |168u | | | tee . | | |" : DEM hillshade " | | |0.0 | | |3.5 | | | | | |$ gdal pipeline read n43.tif ! \ | | | color-map --color-map color_file.txt ! \ | | | tee [ write colored.tif --overwrite ] ! \ | | | blend --operator=hsv-value --overlay \ | | | [ read n43.tif ! hillshade -z 30 ! tee [ write hillshade.tif --overwrite ] ] ! \ | | | write colored-hillshade.tif --overwrite | | | | | | | | |168u | | | | | |168u | | |[] | | |" (RETURN STATUS CODE)" | | | 0 ( )..SH " (EXAMPLES)" | | | : (buffer) | | |0.0 | | |3.5 | | | | | |$ gdal pipeline ! read in.tif ! footprint ! buffer 20 ! write out.gpkg --overwrite | | | | | | | | |168u | | | | | |168u | | | : | | |0.0 | | |3.5 | | | | | |$ gdal pipeline ! read in.gpkg ! rasterize --size 1000,1000 ! reproject --output-crs EPSG:4326 ! write out.tif --overwrite | | | | | | | | |168u | | | | | |168u | | | : CRS | | |0.0 | | |3.5 | | | | | |$ gdal pipeline raster_reproject.gdalg.json --input=my.gpkg --output=out.tif --output-crs=EPSG:32631 | | | | | | | | |168u | | | | | |168u | | | : | | | lines.gpkg lines | | | geom width . | | | (buffer) . | | |0.0 | | |3.5 | | | | | |gdal vector pipeline \ | | | ! read lines.gpkg \ | | | ! sql "SELECT fid, ST_Buffer(geom, width) AS geom FROM lines" \ | | | ! set-geom-type --geometry-type Polygon \ | | | ! write buffered-lines.gpkg --output-layer=BufferedLines --overwrite --overwrite-layer | | | | | | | | |168u | | | | | |168u | | |: | | |0.0 | | |3.5 | | | SQL SELECT * . | | | . | | | . | | | | | |168u | | | | | |168u | | |" (AUTHORS)" | | |Even Rouault | | |" (COPYRIGHT)" | | |1998-2026 | | +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------+ August 18, 2026 GDAL-PIPELINE(1)