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

FreeBSD Manual Pages

  
 
  

home | help
GDAL-RASTER-FILL-NODATA(1)	      GDAL	      GDAL-RASTER-FILL-NODATA(1)

NAME
     gdal-raster-fill-nodata - Fill nodata values in a raster dataset

     Added in version 3.11.

SYNOPSIS
	Usage: gdal raster fill-nodata [OPTIONS] <INPUT> <OUTPUT>

	Fill nodata raster regions by interpolation from edges.

	Positional arguments:
	  -i, --input <INPUT>				       Input raster dataset [required]
	  -o, --output <OUTPUT> 			       Output raster dataset (created by algorithm) [required]

	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]
	  --progress					       Display progress bar

	Options:
	  -f, --of, --format, --output-format <OUTPUT-FORMAT>  Output format
	  --co, --creation-option <KEY>=<VALUE> 	       Creation option [may be repeated]
	  --overwrite					       Whether overwriting existing output is allowed
	  -b, --band <BAND>				       Input band (1-based index) (default: 1)
	  -d, --max-distance <MAX_DISTANCE>		       The maximum distance (in pixels) that the algorithm will search out for values to interpolate. (default: 100)
	  -s, --smoothing-iterations <SMOOTHING_ITERATIONS>    The number of 3x3 average filter smoothing iterations to run after the interpolation to dampen artifacts. The default is zero smoothing iterations. (default: 0)
	  --mask <MASK> 				       Use the first band of the specified file as a validity mask (zero is invalid, non-zero is valid).
	  --strategy <STRATEGY> 			       By default, pixels are interpolated using an inverse distance weighting (invdist). It is also possible to choose a nearest neighbour (nearest) strategy.. STRATEGY=invdist|nearest (default: invdist)

	Advanced Options:
	  --if, --input-format <INPUT-FORMAT>		       Input formats [may be repeated]

DESCRIPTION
     gdal raster fill-nodata fills nodata areas by interpolating from valid pix-
     els around the edges of the area.

     The following options are available:

     -f, --of, --format, --output-format <OUTPUT-FORMAT>
	    Which  output  raster  format to use. Allowed values may be given by
	    gdal --formats | grep raster | grep + | sort

     --output-layer <OUTPUT-LAYER>
	    Output layer name.

     --overwrite
	    Allow program to overwrite existing target file or dataset.   Other-
	    wise,  by default, gdal errors out if the target file or dataset al-
	    ready exists.

     -b <BAND>
	    Select an input <BAND> to be processed. Bands are numbered	from  1.
	    Default is the first band of the input dataset.

     -max-distance <MAX_DISTANCE>
	    Specifies  the  maximum distance (in pixels) that the algorithm will
	    search out for values to interpolate. Default is 100 pixels.

     --smoothing-iterations <SMOOTHING_ITERATIONS>
	    Specifies the number of smoothing iterations to apply to the  filled
	    raster.  This can help to reduce artifacts in the filled areas.  De-
	    fault is 0 iterations.

     --strategy <STRATEGY>
	    Select  the interpolation <STRATEGY> to use.  By default, pixels are
	    interpolated using an inverse distance weighting  (invdist).  It  is
	    also possible to choose a nearest neighbour (nearest) strategy.

     --mask <MASK>
	    Use the first band of the specified file as a validity mask (zero is
	    invalid, non-zero is valid).

EXAMPLES
   Example 1: Fill nodata areas in a raster
     The command specifies to use the second band of the input raster, 50 px max
     distance,	3  smoothing  iterations and the nearest strategy for interpola-
     tion.  The output will be saved in output.tif.

	gdal raster fill-nodata -b 2 --max-distance 50 --smoothing-iterations 3 \
	    --strategy nearest --mask mask.tif \
	    input.tif output.tif

AUTHOR
     Alessandro Pasotti <elpaso@itopen.it>

COPYRIGHT
     1998-2025

				  Oct 29, 2025	      GDAL-RASTER-FILL-NODATA(1)

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

home | help