Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
GDAL_PANSHARPEN(1)		      GDAL		      GDAL_PANSHARPEN(1)

NAME
     gdal_pansharpen -	Perform a pansharpen operation.

SYNOPSIS
	gdal_pansharpen [--help] [--help-general]
			<pan_dataset>
			<spectral_dataset>[,band=<num>] [<spectral_dataset>[,band=<num>]]...
			<out_dataset>
			[-of <format>] [-b <band>]... [-w <weight_val>]...
			[-r {nearest|bilinear|cubic|cubicspline|lanczos|average}]
			[-threads {ALL_CPUS|<number>}] [-bitdepth <val>] [-nodata <val>]
			[-spat_adjust {union|intersection|none|nonewithoutwarning}]
			[-co <NAME>=<VALUE>]... [-q]

DESCRIPTION
     gdal_pansharpen performs a pan-sharpening operation. It can create a "clas-
     sic"  output  dataset  (such  as  GeoTIFF), or a VRT dataset describing the
     pan-sharpening operation.

     More details can be found in the Pansharpened VRT section.

     NOTE:
	gdal_pansharpen is a Python utility,  and  is  only  available	if  GDAL
	Python bindings are available.

     TIP:
	Equivalent in new "gdal" command line interface:

	See gdal raster pansharpen.

     --help
	    Show this help message and exit

     --help-general
	    Gives a brief usage message for the generic GDAL commandline options
	    and exit.

     -of <format>
	    Select  the  output  format. If not specified, the format is guessed
	    from the extension. Use the short format name. VRT can also be used.

     -b <band>
	    Select band band from the input spectral bands for output. Bands are
	    numbered from 1 in the order spectral bands are specified.	Multiple
	    -b switches may be used. When no -b switch is used, all input  spec-
	    tral bands are set for output.

     -w <weight_val>
	    Specify  a	weight	for  the  computation of the pseudo panchromatic
	    value. There must be as many -w switches as input spectral bands.

     -r {nearest|bilinear|cubic|cubicspline|lanczos|average}
	    Select a resampling algorithm. cubic is the default.

     -threads {ALL_CPUS|<number>}
	    Specify number of threads to use to do the resampling and pan-sharp-
	    ening itself. Can be an integer number or ALL_CPUS.

     -bitdepth <val>
	    Specify the bit depth of the panchromatic and spectral  bands  (e.g.
	    12). If not specified, the NBITS metadata item from the panchromatic
	    band will be used if it exists.

     -nodata <val>
	    Specify  nodata  value  for  bands.  Used  for  the  resampling  and
	    pan-sharpening computation itself. If not set, deduced from the  in-
	    put bands, provided they have a consistent setting.

     -spat_adjust {union|intersection|none|nonewithoutwarning}
	    Select  behavior when bands have not the same extent. See SpatialEx-
	    tentAdjustment documentation in Pansharpened VRT union  is	the  de-
	    fault.

     -co <NAME>=<VALUE>
	    Many  formats have one or more optional creation options that can be
	    used to control particulars about the file	created.  For  instance,
	    the GeoTIFF driver supports creation options to control compression,
	    and whether the file should be tiled.

	    The  creation options available vary by format driver, and some sim-
	    ple formats have no creation options at all. A list of options  sup-
	    ported for a format can be listed with the --format command line op-
	    tion  but  the documentation for the format is the definitive source
	    of information on driver creation options.	See Raster drivers  for-
	    mat  specific documentation for legal creation options for each for-
	    mat.

     -q     Suppress progress monitor and other non-error output.

     <pan_dataset>
	    Dataset with panchromatic band (first band will be used).

     <spectral_dataset>[,band=<num>]
	    Dataset with one or several spectral bands. If the	band  option  is
	    not  specified,  all  bands  of the datasets are taken into account.
	    Otherwise, only the specified (num)th band. The same dataset can  be
	    repeated several times.

     <out_dataset>
	    Output dataset

     Bands should be in the same projection.

RETURN STATUS CODE
     The  program returns status code 0 in case of success, and non-zero in case
     of error (non-blocking errors emitted as warnings are considered as a  suc-
     cessful execution).

EXAMPLE
   Example 1: With spectral bands in a single dataset
	gdal_pansharpen panchro.tif multispectral.tif pansharpened_out.tif

   Example 2: With a few spectral bands from a single dataset, reordered
	gdal_pansharpen panchro.tif multispectral.tif,band=3 multispectral.tif,band=2 multispectral.tif,band=1 pansharpened_out.tif

   Example 3: With spectral bands in several datasets
	gdal_pansharpen panchro.tif band1.tif band2.tif band3.tif pansharpened_out.tif

   Example 4: Specifying weights
	gdal_pansharpen -w 0.7 -w 0.2 -w 0.1 panchro.tif multispectral.tif pansharpened_out.tif

   Example  5:	Specify RGB bands from a RGBNir multispectral dataset while com-
     puting the pseudo panchromatic intensity on the 4 RGBNir bands
	gdal_pansharpen -b 1 -b 2 -b 3 panchro.tif rgbnir.tif pansharpened_out.tif

AUTHOR
     Even Rouault <even.rouault@spatialys.com>

COPYRIGHT
     1998-2026

				  Jun 05, 2026		      GDAL_PANSHARPEN(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gdal_pansharpen&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help