<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>GDAL: gdal_proximity</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.2-20100208 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1><a class="anchor" id="gdal_proximity">gdal_proximity </a></h1><p>produces a raster proximity map</p>
<h2><a class="anchor" id="synopsis">
SYNOPSIS</a></h2>
<div class="fragment"><pre class="fragment">
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]
</pre></div><h2><a class="anchor" id="description">
DESCRIPTION</a></h2>
<p>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.</p>
<dl>
<dt><em>srcfile</em></dt>
<dd><p class="startdd">The source raster file used to identify target pixels.</p>
<p class="enddd"></p>
</dd>
<dt><em>dstfile</em></dt>
<dd><p class="startdd">The destination raster file to which the proximity map will be written.</p>
<p class="enddd"></p>
</dd>
<dt><b>-srcband</b> <em>n</em></dt>
<dd><p class="startdd">Identifies the band in the source file to use (default is 1).</p>
<p class="enddd"></p>
</dd>
<dt><b>-srcband</b> <em>n</em></dt>
<dd><p class="startdd">Identifies the band in the destination file to use (default is 1).</p>
<p class="enddd"></p>
</dd>
<dt><b>-of</b> <em>format</em>:</dt>
<dd><p class="startdd">Select the output format. The default is GeoTIFF (GTiff). Use the short format name. </p>
<p class="enddd"></p>
</dd>
<dt><b>-co</b> <em>"NAME=VALUE"</em>:</dt>
<dd><p class="startdd">passes a creation option to the output format driver. Multiple <b>-co</b> options may be listed. See format specific documentation for legal creation options for each format. </p>
<p class="enddd"></p>
</dd>
<dt><b>-ot</b> <em>datatype</em>:</dt>
<dd><p class="startdd">Force the output image bands to have a specific type. Use type names (ie. Byte, Int16,...) </p>
<p class="enddd"></p>
</dd>
<dt><b>-values</b> <em>n,n,n</em>:</dt>
<dd><p class="startdd">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. </p>
<p class="enddd"></p>
</dd>
<dt><b>-distunits</b> <em>PIXEL/GEO</em>:</dt>
<dd><p class="startdd">Indicate whether distances generated should be in pixel or georeferenced coordinates (default PIXEL). </p>
<p class="enddd"></p>
</dd>
<dt><b>-maxdist</b> <em>n</em>:</dt>
<dd><p class="startdd">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. </p>
<p class="enddd"></p>
</dd>
<dt><b>-nodata</b> <em>n</em>:</dt>
<dd><p class="startdd">Specify a nodata value to use for the destination proximity raster. </p>
<p class="enddd"></p>
</dd>
<dt><b>-fixed-buf-val</b> <em>n</em>:</dt>
<dd><p class="startdd">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. </p>
<p class="enddd"></p>
</dd>
</dl>
</div>
<hr>
Generated for GDAL by
<a href="http://www.doxygen.org/index.html"><img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.6.2-20100208.
</body>
</html>
