---
name: "gdal_fillnodata"
section: "1"
platform: "linux"
package: "gdal"
version: "3.13.3-6"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gdal_fillnodata"
---

# gdal\_fillnodata(1)

Fill raster regions by interpolation from edges.

## NAME

gdal\_fillnodata - Fill raster regions by interpolation from edges.

## SYNOPSIS

```
gdal_fillnodata [--help] [--help-general] [-q] [-md <max_distance>]
           [-si <smoothing_iterations>] [-o <name>=<value> [<name>=<value> ...]]
           [-mask <filename>] [-interp {inv_dist,nearest}] [-b <band>]
           [-of <gdal_format>] [-co <name>=<value>]
           <src_file> <dst_file>
```

## DESCRIPTION

**gdal\_fillnodata** fills selection regions (usually nodata areas) by interpolating from valid pixels around the edges of the area.

Additional details on the algorithm are available in the *GDALFillNodata()* docs.

**TIP:**

Equivalent in new "gdal" command line interface:

See *gdal raster fill-nodata*.

**NOTE:**

gdal\_fillnodata is a Python utility, and is only available if GDAL Python bindings are available.

- **--help**

  Show this help message and exit

- **--help-general**

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

- **-q**

  The script runs in quiet mode. The progress monitor is suppressed and routine messages are not displayed.

- **-md \<max\_distance\>**

  The maximum distance (in pixels) that the algorithm will search out for values to interpolate. The default is 100 pixels.

- **-si \<smooth\_iterations\>**

  The number of 3x3 average filter smoothing iterations to run after the interpolation to dampen artifacts. The default is zero smoothing iterations.

- **-o \<name\>=\<value\>**

  Specify a special argument to the algorithm. Currently none are supported.

- **-b \<band\>**

  The band to operate on, by default the first band is operated on.

- **-mask \<filename\>**

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

- **-of \<format\>**

  Select the output format. The default is *GTiff -- GeoTIFF File Format*. Use the short format name.

- **-interp {inv\_dist,nearest}**

  Added in version 3.9.

  By default, pixels are interpolated using an inverse distance weighting (**inv\_dist**). It is also possible to choose a nearest neighbour (**nearest**) strategy.

- **\<srcfile\>**

  The source raster file used to identify target pixels. Only one band is used.

- **\<dstfile\>**

  The new file to create with the interpolated result.

## 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 successful execution).

## AUTHOR

Frank Warmerdam \<warmerdam@pobox.com\>

## COPYRIGHT

1998-2026