GDAL-RASTER(1)

📦
version 3.13.3 · 7 versions
, in alpine 3.24, arch rolling, ubuntu stonking

💖 NAME 💖

okay so hi bestie, welcome to gdal-raster — the entry point for raster commands ✨ it's giving main character energy for the whole raster side of GDAL.

she's new-new, btw: added in version 3.11 🎀

The man page you're reading is gdal-raster(1), from the GDAL manual ✨

🦋 SYNOPSIS 🦋

so here's the vibe check on how you actually call her:

Usage: gdal raster <SUBCOMMAND> [OPTIONS]
where <SUBCOMMAND> is one of:
  - as-features:     Create features from pixels of a raster dataset
  - aspect:          Generate an aspect map
  - blend:           Blend/compose two raster datasets
  - calc:            Perform raster algebra
  - clean-collar:    Clean the collar of a raster dataset, removing noise.
  - clip:            Clip a raster dataset.
  - color-map:       Generate a RGB or RGBA dataset from a single band, using a color map
  - compare:         Compare two raster datasets.
  - contour:         Creates a vector contour from a raster elevation model (DEM).
  - convert:         Convert a raster dataset.
  - create:          Create a new raster dataset.
  - edit:            Edit a raster dataset.
  - fill-nodata:     Fill nodata raster regions by interpolation from edges.
  - footprint:       Compute the footprint of a raster dataset.
  - hillshade:       Generate a shaded relief map
  - index:           Create a vector index of raster datasets.
  - info:            Return information on a raster dataset.
  - mosaic:          Build a mosaic, either virtual (VRT) or materialized.
  - neighbors:       Compute the value of each pixel from its neighbors (focal statistics) (alias: neighbours)
  - nodata-to-alpha: Replace nodata value(s) with an alpha band.
  - overview:        Manage overviews of a raster dataset.
  - pansharpen:      Perform a pansharpen operation.
  - pipeline:        Process a raster dataset applying several steps.
  - pixel-info:      Return information on a pixel of a raster dataset.
  - polygonize:      Create a polygon feature dataset from a raster band.
  - proximity:       Produces a raster proximity map.
  - reclassify:      Reclassify values in a raster dataset
  - reproject:       Reproject a raster dataset.
  - resize:          Resize a raster dataset without changing the georeferenced extents.
  - rgb-to-palette:  Convert a RGB image into a pseudo-color / paletted image.
  - roughness:       Generate a roughness map
  - scale:           Scale the values of the bands of a raster dataset.
  - select:          Select a subset of bands from a raster dataset.
  - set-type:        Modify the data type of bands of a raster dataset.
  - sieve:           Remove small polygons from a raster dataset.
  - slope:           Generate a slope map
  - stack:           Combine together input bands into a multi-band output, either virtual (VRT) or materialized.
  - tile:            Generate tiles in separate files from a raster dataset.
  - tpi:             Generate a Topographic Position Index (TPI) map
  - tri:             Generate a Terrain Ruggedness Index (TRI) map
  - unscale:         Convert scaled values of a raster dataset into unscaled values.
  - update:          Update the destination raster with the content of the input one.
  - viewshed:        Compute the viewshed of a raster dataset.
  - zonal-stats:     Calculate raster zonal statistics

Common Options:
  -h, --help              Display help message and exit
  --json-usage            Display usage as JSON document and exit
  --config <KEY>=<VALUE>  Configuration option [may be repeated]

Options:
  --drivers               Display raster driver list as JSON document

like, literally a whole menu of slay 💅

🌸 Common Options 🌸

  • -h, --help — show the help message and dip out. classic, iconic, never fails 🫶
  • --json-usage — prints the usage as a JSON document and exits, for when you want your help in machine-readable form 🤖
  • --config <KEY>=<VALUE> — set a configuration option. this one may be repeated (stack 'em up bestie) ✨

⭐ Options ⭐

  • --drivers — spits out the raster driver list as a JSON document. so you can see every driver format she fw 👑

👑 AVAILABLE SUB-COMMANDS 👑

the full roster, no cap, nothing skipped:

  • gdal raster info
  • gdal raster aspect
  • gdal raster blend
  • gdal raster calc
  • gdal raster clean-collar
  • gdal raster clip
  • gdal raster color-map
  • gdal raster compare
  • gdal raster convert
  • gdal raster create
  • gdal raster footprint
  • gdal raster fill-nodata
  • gdal raster hillshade
  • gdal raster index
  • gdal raster mosaic
  • gdal raster neighbors
  • gdal raster nodata-to-alpha
  • gdal raster overview
  • gdal raster pipeline
  • gdal raster pixel-info
  • gdal raster polygonize
  • gdal raster proximity
  • gdal raster reproject
  • gdal raster resize
  • gdal raster rgb-to-palette
  • gdal raster roughness
  • gdal raster scale
  • gdal raster select
  • gdal raster sieve
  • gdal raster slope
  • gdal raster stack
  • gdal raster tile
  • gdal raster tpi
  • gdal raster tri
  • gdal raster unscale
  • gdal raster update
  • gdal raster viewshed
no, bestie, as-features, contour, reclassify, set-type and zonal-stats are in the usage list up top but not in this available-sub-commands list. that's just how the page is. i report, you enjoy 🙈

🌈 EXAMPLES 🌈

✨ Example 1: Getting information on the file utm.tif (with text output) ✨

$ gdal raster info utm.tif

text output, classic, clean, vibe check passed 💖

🎀 Example 2: Converting file utm.tif to GeoPackage raster 🎀

$ gdal raster convert utm.tif utm.gpkg

one line and she's converted, it's giving effortless 🦋

💅 Example 3: Getting the list of raster drivers (with JSON output) 💅

$ gdal raster --drivers

JSON drippp 🔥

💜 AUTHOR 💜

Even Rouault <even.rouault@spatialys.com> — the actual legend behind this, we stan 🫶

1998-2026

and that's the whole page bestie, that's a wrap on gdal-raster(1) — sourced from GDAL, version stamped Aug 18, 2026. go forth and raster, you ate 💅 ✨ 🌈

📦 where this page comes from