1GDAL_PROXIMITY(1) GDAL GDAL_PROXIMITY(1)
2
3
4
6 gdal_proximity - Produces a raster proximity map.
7
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
17 The gdal_proximity.py script generates a raster proximity map indicat‐
18 ing the distance from the center of each pixel to the center of the
19 nearest pixel identified as a target pixel. Target pixels are those in
20 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 src‐
29 file. 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
36 1).
37
38 -of <format>
39 Select the output format. Starting with GDAL 2.3, if not speci‐
40 fied, the format is guessed from the extension (previously was
41 GTiff). Use the short format name.
42
43 -co <NAME=VALUE>
44 Many formats have one or more optional creation options that can
45 be used to control particulars about the file created. For
46 instance, the GeoTIFF driver supports creation options to con‐
47 trol compression, and whether the file should be tiled.
48
49 The creation options available vary by format driver, and some
50 simple formats have no creation options at all. A list of
51 options supported for a format can be listed with the --formats
52 command line option but the documentation for the format is the
53 definitive source of information on driver creation options.
54 See raster_drivers format specific documentation for legal cre‐
55 ation options for each format.
56
57 -ot <type>
58 Force the output image bands to have a specific type. Use type
59 names (i.e. Byte, Int16,...)
60
61 -values <n>,<n>,<n>
62 A list of target pixel values in the source image to be consid‐
63 ered target pixels. If not specified, all non-zero pixels will
64 be considered target pixels.
65
66 -distunits PIXEL|GEO
67 Indicate whether distances generated should be in pixel or geo‐
68 referenced coordinates (default PIXEL).
69
70 -maxdist <n>
71 The maximum distance to be generated. The nodata value will be
72 used for pixels beyond this distance. If a nodata value is not
73 provided, the output band will be queried for its nodata value.
74 If the output band does not have a nodata value, then the value
75 65535 will be used. Distance is interpreted in pixels unless
76 -distunits GEO is specified.
77
78 -nodata <n>
79 Specify a nodata value to use for the destination proximity
80 raster.
81
82 -use_input_nodata YES/NO
83 Indicate whether nodata pixels in the input raster should be
84 nodata in the output raster (default NO).
85
86 -fixed-buf-val <n>
87 Specify a value to be applied to all pixels that are within the
88 -maxdist of target pixels (including the target pixels) instead
89 of a distance value.
90
92 Frank Warmerdam <warmerdam@pobox.com>
93
95 1998-2021
96
97
98
99
100 Jan 05, 2021 GDAL_PROXIMITY(1)