NAME

       gdal_merge - gdal_merge.py mosaics a set of images

SYNOPSIS

       gdal_merge.py [-o out_filename] [-of out_format] [-co NAME=VALUE]*
                     [-ps pixelsize_x pixelsize_y] [-tap] [-separate] [-v] [-pct]
                     [-ul_lr ulx uly lrx lry] [-n nodata_value] [-init "value [value...]"]
                     [-ot datatype] [-createonly] input_files

DESCRIPTION

       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. In areas of overlap, the last image will be copied over earlier
       ones.

       -o out_filename:
           The name of the output file, which will be created if it does not already exist
           (defaults to 'out.tif').

       -of format:
           Output format, defaults to GeoTIFF (GTiff).

       -co NAME=VALUE:
           Creation option for output file. Multiple options can be specified.

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

       -ps pixelsize_x pixelsize_y:
           Pixel size to be used for the output file. If not specified the resolution of the
           first input file will be used.

       -tap:
           (GDAL >= 1.8.0) (target aligned pixels) align the coordinates of the extent of the
           output file to the values of the -tr, such that the aligned extent includes the
           minimum extent.

       -ul_lr ulx uly lrx lry:
           The extents of the output file. If not specified the aggregate extents of all input
           files will be used.

       -v:
           Generate verbose output of mosaicing operations as they are done.

       -separate:
           Place each input file into a separate stacked band.

       -pct:
           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.

       -n nodata_value:
           Ignore pixels from files being merged in with this pixel value.

       -a_nodata output_nodata_value:
           (GDAL >= 1.9.0) Assign a specified nodata value to output bands.

       -init 'value(s)':
           Pre-initialize the output image bands with these values. However, it is not marked as
           the nodata value in the output file. If only one value is given, the same value is
           used in all the bands.

       -createonly:
           The output file is created (and potentially pre-initialized) but no input image data
           is copied into it.

       NOTE: gdal_merge.py is a Python script, and will only work if GDAL was built with Python
       support.

EXAMPLE

       Create an image with the pixels in all bands initialized to 255.

       % gdal_merge.py -init 255 -o out.tif in1.tif in2.tif

       Create an RGB image that shows blue in pixels with no data. The first two bands will be
       initialized to 0 and the third band will be initialized to 255.

       % gdal_merge.py -init "0 0 255" -o out.tif in1.tif in2.tif

AUTHORS

       Frank Warmerdam warmerdam@pobox.com, Silke Reimer silke@intevation.de