GDAL-RASTER-PANSHARPEN(1)            GDAL            GDAL-RASTER-PANSHARPEN(1)

<?><?><?> (NAME)
       gdal-raster-pansharpen - <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> (Pan-sharpening)

       <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> 3.12.


<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)

          Usage: gdal raster pansharpen [OPTIONS] <INPUT> <SPECTRAL>... <OUTPUT>

          Perform a pansharpen operation.

          Positional arguments:
            -i, --panchromatic, --input <INPUT>                      Input panchromatic raster dataset [required] [not available in pipelines]
            --spectral <SPECTRAL>                                    Input spectral band dataset [1.. values] [required]
            -o, --output <OUTPUT>                                    Output raster dataset [required] [not available in pipelines]

          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]
            -q, --quiet                                              Quiet mode (no progress bar or warning message) [not available in pipelines]

          Options:
            -f, --of, --format, --output-format <OUTPUT-FORMAT>      Output format ("GDALG" allowed) [not available in pipelines]
            --co, --creation-option <KEY>=<VALUE>                    Creation option [may be repeated] [not available in pipelines]
            --overwrite                                              Whether overwriting existing output dataset is allowed [not available in pipelines]
                                                                     Mutually exclusive with --append
            --append                                                 Append as a subdataset to existing output [not available in pipelines]
                                                                     Mutually exclusive with --overwrite
            -r, --resampling <RESAMPLING>                            Resampling algorithm. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average (default: cubic)
            --weights <WEIGHTS>                                      Weight for each input spectral band [may be repeated]
            --nodata <NODATA>                                        Override nodata value of input bands
            --bit-depth <BIT-DEPTH>                                  Override bit depth of input bands
            --spatial-extent-adjustment <SPATIAL-EXTENT-ADJUSTMENT>  Select behavior when bands have not the same extent. SPATIAL-EXTENT-ADJUSTMENT=union|intersection|none|none-without-warning (default: union)
            -j, --num-threads <NUM-THREADS>                          Number of jobs (or ALL_CPUS) (default: ALL_CPUS)

          Advanced Options:
            --if, --input-format <INPUT-FORMAT>                      Input formats [may be repeated] [not available in pipelines]
            --oo, --open-option <KEY>=<VALUE>                        Open options [may be repeated] [not available in pipelines]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> gdal raster pansharpen <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> (pan-sharpening <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?>) <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <<<?><?><?><?><?><?>>> (<?><?><?><?><?> GeoTIFF) <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> VRT <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>.
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> (<?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>) <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> (CRS) <?><?><?><?><?>
       <?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?> Pansharpened VRT <?><?><?><?>.

<?><?><?><?><?> GDALG (<?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> / <?><?><?><?><?><?>) (GDALG
       OUTPUT)
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?> JSON
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> GDALG
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> GDALG: GDAL Streamed
       Algorithm <?><?><?> <?><?><?> <?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> / <?><?><?><?><?><?> (on-the-fly / streamed)
       <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       (PROGRAM-SPECIFIC OPTIONS)

       --bit-depth <val>
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?> 12). <?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              NBITS <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

       -i, --panchromatic, --input <INPUT>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?>. [<?><?><?><?><?><?>]

       -j, --num-threads <value>
              <?><?><?><?><?> <?><?><?><?><?><?><?> (threads) <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?> ALL_CPUS (<?><?><?><?><?><?><?>)
              <?><?><?><?>.

       --nodata <val>
              <?><?><?><?><?> nodata <?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?>
              <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.

       -r, --resampling nearest|bilinear|cubic|cubicspline|lanczos|average
              <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>.  cubic <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>.

       --spatial-extent-adjustment
       union|intersection|none|none-without-warning
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?><?><?><?>
              SpatialExtentAdjustment <?><?> Pansharpened VRT <?><?>
              <?><?><?><?><?><?>.  union <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?>.

       --spectral <spectral_dataset>[,band=<num>]
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?>. [<?><?><?><?><?><?>]

              <?><?><?> <?><?><?><?><?> band <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>. <?><?>
              <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              (num) <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?>.

       --weights <WEIGHTS>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (STANDARD OPTIONS)

       --append
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?> (subdataset)
              <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> GTiff -- GeoTIFF File Format <?> GPKG --
              GeoPackage raster <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       --co, --creation-option <NAME>=<VALUE>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?>. <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
              GeoTIFF <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (tiled) <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> --formats <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?>. <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              Raster drivers <?><?> <?><?><?><?><?><?>.

       --if, --input-format <format>
              <?><?><?> <?><?><?><?>/<?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?>(<?><?><?>) <?><?><?><?><?>. <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       --oo, --open-option <NAME>=<VALUE>
              <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> (<?><?><?><?> <?><?><?><?>).

              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       -f, --of, --format, --output-format <OUTPUT-FORMAT>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>. <?><?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
              <?><?> <?><?><?> <?><?><?><?>: gdal --formats | grep raster |
              grep rw | sort

       --overwrite
              <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?>. <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> gdal <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> (RETURN STATUS CODE)
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> 0 <?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       (<?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>).

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?> <?>: <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>

          gdal raster pansharpen panchro.tif rgb.tif pansharpened_out.tif

   <?><?><?><?> <?>: <?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>

          gdal raster pansharpen panchro.tif bgr.tif,band=3 bgr.tif,band=2 bgr.tif,band=1 pansharpened_out.tif

   <?><?><?><?> <?>: <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>

          gdal raster pansharpen panchro.tif red.tif green.tif blue.tif pansharpened_out.tif

   <?><?><?><?> <?>: <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>

          gdal raster pansharpen -w 0.7,0.2,0.1 panchro.tif multispectral.tif pansharpened_out.tif

   <?><?><?><?> <?>: <?><?><?><?><?><?> <?><?><?><?><?><?><?> RGB <?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> RGBNir
       <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?> <?><?><?><?> RGBNir

          gdal raster pipeline read panchro.tif ! pansharpen rgbnir.tif ! select 1,2,3 ! write pansharpened_out.tif

<?><?><?><?><?><?><?> (AUTHOR)
       Even Rouault <even.rouault@spatialys.com>

<?><?> <?><?><?> (COPYRIGHT)
       1998-2026

                                August 18, 2026      GDAL-RASTER-PANSHARPEN(1)