1gdal_proximity(1)           General Commands Manual          gdal_proximity(1)
2
3
4

NAME

6       gdal_proximityProduces a raster proximity map.
7

SYNOPSIS

9       gdal_proximity.py srcfile dstfile [-srcband n] [-dstband n]
10                         [-of format] [-co name=value]*
11                         [-ot Byte/Int16/Int32/Float32/etc]
12                         [-values n,n,n] [-distunits PIXEL/GEO]
13                         [-maxdist n] [-nodata n] [-use_input_nodata YES/NO]
14                         [-fixed-buf-val n]
15

DESCRIPTION

17       The gdal_proximity.py script generates a raster proximity map
18       indicating the distance from the center of each pixel to the center of
19       the nearest pixel identified as a target pixel. Target pixels are those
20       in the source raster for which the raster pixel value is in the set of
21       target pixel values.
22
23       srcfile
24           The source raster file used to identify target pixels.
25
26       dstfile
27           The destination raster file to which the proximity map will be
28           written. It may be a pre-existing file of the same size as srcfile.
29           If it does not exist it will be created.
30
31       -srcband n
32           Identifies the band in the source file to use (default is 1).
33
34       -dstband n
35           Identifies the band in the destination file to use (default is 1).
36
37       -of format:
38           Select the output format. Starting with GDAL 2.3, if not specified,
39           the format is guessed from the extension (previously was GTiff).
40           Use the short format name.
41
42       -co 'NAME=VALUE':
43           passes a creation option to the output format driver. Multiple -co
44           options may be listed. See format specific documentation for legal
45           creation options for each format.
46
47       -ot datatype:
48           Force the output image bands to have a specific type. Use type
49           names (i.e. Byte, Int16,...)
50
51       -values n,n,n:
52           A list of target pixel values in the source image to be considered
53           target pixels. If not specified, all non-zero pixels will be
54           considered target pixels.
55
56       -distunits PIXEL/GEO:
57           Indicate whether distances generated should be in pixel or
58           georeferenced coordinates (default PIXEL).
59
60       -maxdist n:
61           The maximum distance to be generated. The nodata value will be used
62           for pixels beyond this distance. If a nodata value is not provided,
63           the output band will be queried for its nodata value. If the output
64           band does not have a nodata value, then the value 65535 will be
65           used. Distance is interpreted in pixels unless -distunits GEO is
66           specified.
67
68       -nodata n:
69           Specify a nodata value to use for the destination proximity raster.
70
71       -use_input_nodata YES/NO:
72           (GDAL >= 2.0) Indicate whether nodata pixels in the input raster
73           should be nodata in the output raster (default NO).
74
75       -fixed-buf-val n:
76           Specify a value to be applied to all pixels that are within the
77           -maxdist of target pixels (including the target pixels) instead of
78           a distance value.
79

AUTHORS

81       Frank Warmerdam warmerdam@pobox.com
82
83
84
85GDAL                            Thu Jul 25 2019              gdal_proximity(1)
Impressum