<!-- This comment will put IE 6, 7 and 8 in quirks mode -->
<!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_merge.py</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javaScript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body onload='searchBox.OnSelectItem(0);'>
<!-- Generated by Doxygen 1.6.2-20100208 -->
<script type="text/javascript"><!--
var searchBox = new SearchBox("searchBox", "search",false,'Search');
--></script>
<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>
<div id="MSearchBox" class="MSearchBoxInactive">
<img id="MSearchSelect" src="search/search.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</div>
</li>
</ul>
</div>
</div>
<div class="contents">
<h1><a class="anchor" id="gdal_merge">gdal_merge.py </a></h1><p>mosaics a set of images</p>
<h2><a class="anchor" id="gsynopsis">
SYNOPSIS</a></h2>
<div class="fragment"><pre class="fragment">
gdal_merge.py [-o out_filename] [-of out_format] [-co NAME=VALUE]*
[-ps pixelsize_x pixelsize_y] [-separate] [-v] [-pct]
[-ul_lr ulx uly lrx lry] [-n nodata_value] [-init value]
[-ot datatype] [-createonly] input_files
</pre></div><h2><a class="anchor" id="gdescription">
DESCRIPTION</a></h2>
<p>This utility will automatically mosaic a set of images. All the images must be in the same coordinate system and have a matching number of bands, but they may be overlapping, and at different resolutions.</p>
<dl>
<dt><b>-o</b> <em>out_filename</em>:</dt>
<dd>The name of the output file, which will be created if it does not already exist (defaults to "out.tif"). </dd>
<dt><b>-of</b> <em>format</em>:</dt>
<dd>Output format, defaults to GeoTIFF (GTiff). </dd>
<dt><b>-co</b> <em>NAME=VALUE</em>:</dt>
<dd>Creation option for output file. Multiple options can be specified. </dd>
<dt><b>-ot</b> <em>datatype</em>:</dt>
<dd>Force the output image bands to have a specific type. Use type names (ie. Byte, Int16,...) </dd>
<dt><b>-ps</b> <em>pixelsize_x pixelsize_y</em>:</dt>
<dd>Pixel size to be used for the output file. If not specified the resolution of the first input file will be used. </dd>
<dt><b>-ul_lr</b> <em>ulx uly lrx lry</em>:</dt>
<dd>The extents of the output file. If not specified the aggregate extents of all input files will be used. </dd>
<dt></dt>
<dd></dd>
<dt><b>-v</b>:</dt>
<dd>Generate verbose output of mosaicing operations as they are done. </dd>
<dt><b>-separate</b>:</dt>
<dd>Place each input file into a separate <em>stacked</em> band. </dd>
<dt><b>-pct</b>:</dt>
<dd>Grab a pseudocolor table from the first input image, and use it for the output. Merging pseudocolored images this way assumes that all input files use the same color table. </dd>
<dt><b>-n</b> <em>nodata_value</em>:</dt>
<dd>Ignore pixels from files being merged in with this pixel value. </dd>
<dt><b>-init</b> <em>value</em>:</dt>
<dd>Pre-initialize the output file with this value. However, it is not marked as the nodata value in the output file. </dd>
<dt><b>-createonly</b>:</dt>
<dd>The output file is created (and potentially pre-initialized) but no input image data is copied into it. </dd>
</dl>
<p>NOTE: gdal_merge.py is a Python script, and will only work if GDAL was built with Python support. </p>
</div>
<!--- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</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>
