OnWorks favicon

gdal_proximity - Online in the Cloud

Run gdal_proximity in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command gdal_proximity that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



gdal_proximity - gdal_proximity.py produces a raster proximity map


gdal_proximity.py srcfile dstfile [-srcband n] [-dstband n]
[-of format] [-co name=value]*
[-ot Byte/Int16/Int32/Float32/etc]
[-values n,n,n] [-distunits PIXEL/GEO]
[-maxdist n] [-nodata n] [-fixed-buf-val n]


The gdal_proximity.py script generates a raster proximity map indicating the distance from
the center of each pixel to the center of the nearest pixel identified as a target pixel.
Target pixels are those in the source raster for which the raster pixel value is in the
set of target pixel values.

The source raster file used to identify target pixels.

The destination raster file to which the proximity map will be written. It may be a
pre-existing file of the same size as srcfile. If it does not exist it will be

-srcband n
Identifies the band in the source file to use (default is 1).

-dstband n
Identifies the band in the destination file to use (default is 1).

-of format:
Select the output format. The default is GeoTIFF (GTiff). Use the short format name.

passes a creation option to the output format driver. Multiple -co options may be
listed. See format specific documentation for legal creation options for each format.

-ot datatype:
Force the output image bands to have a specific type. Use type names (ie. Byte,

-values n,n,n:
A list of target pixel values in the source image to be considered target pixels. If
not specified, all non-zero pixels will be considered target pixels.

-distunits PIXEL/GEO:
Indicate whether distances generated should be in pixel or georeferenced coordinates
(default PIXEL).

-maxdist n:
The maximum distance to be generated. All pixels beyond this distance will be assigned
either the nodata value, or 65535. Distance is interpreted in pixels unless -distunits
GEO is specified.

-nodata n:
Specify a nodata value to use for the destination proximity raster.

-fixed-buf-val n:
Specify a value to be applied to all pixels that are within the -maxdist of target
pixels (including the target pixels) instead of a distance value.


Frank Warmerdam [email protected]

Use gdal_proximity online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

Linux commands