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

NAME

6       gdal_mergeMosaics a set of images.
7

SYNOPSIS

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

DESCRIPTION

16       This utility will automatically mosaic a set of images. All the images
17       must be in the same coordinate system and have a matching number of
18       bands, but they may be overlapping, and at different resolutions. In
19       areas of overlap, the last image will be copied over earlier ones.
20
21       -o out_filename:
22           The name of the output file, which will be created if it does not
23           already exist (defaults to 'out.tif').
24
25       -of format:
26           Select the output format. Starting with GDAL 2.3, if not specified,
27           the format is guessed from the extension (previously was GTiff).
28           Use the short format name.
29
30       -co NAME=VALUE:
31           Creation option for output file. Multiple options can be specified.
32           See format specific documentation for legal creation options for
33           each format
34
35       -ot datatype:
36           Force the output image bands to have a specific type. Use type
37           names (i.e. Byte, Int16,...)
38
39       -ps pixelsize_x pixelsize_y:
40           Pixel size to be used for the output file. If not specified the
41           resolution of the first input file will be used.
42
43       -tap:
44           (GDAL >= 1.8.0) (target aligned pixels) align the coordinates of
45           the extent of the output file to the values of the -tr, such that
46           the aligned extent includes the minimum extent.
47
48       -ul_lr ulx uly lrx lry:
49           The extents of the output file. If not specified the aggregate
50           extents of all input files will be used.
51
52
53
54       -v:
55           Generate verbose output of mosaicing operations as they are done.
56
57       -separate:
58           Place each input file into a separate band.
59
60       -pct:
61           Grab a pseudo-color table from the first input image, and use it
62           for the output. Merging pseudo-colored images this way assumes that
63           all input files use the same color table.
64
65       -n nodata_value:
66           Ignore pixels from files being merged in with this pixel value.
67
68       -a_nodata output_nodata_value:
69           (GDAL >= 1.9.0) Assign a specified nodata value to output bands.
70
71       -init 'value(s)':
72           Pre-initialize the output image bands with these values. However,
73           it is not marked as the nodata value in the output file. If only
74           one value is given, the same value is used in all the bands.
75
76       -createonly:
77           The output file is created (and potentially pre-initialized) but no
78           input image data is copied into it.
79
80       NOTE: gdal_merge.py is a Python script, and will only work if GDAL was
81       built with Python support.
82

EXAMPLE

84       Create an image with the pixels in all bands initialized to 255.
85
86       % gdal_merge.py -init 255 -o out.tif in1.tif in2.tif
87
88       Create an RGB image that shows blue in pixels with no data. The first
89       two bands will be initialized to 0 and the third band will be
90       initialized to 255.
91
92       % gdal_merge.py -init "0 0 255" -o out.tif in1.tif in2.tif
93

AUTHORS

95       Frank Warmerdam warmerdam@pobox.com, Silke Reimer silke@intevation.de
96
97
98
99GDAL                            Tue Mar 3 2020                   gdal_merge(1)
Impressum