1gdalbuildvrt(1) General Commands Manual gdalbuildvrt(1)
2
6 gdalbuildvrtBuilds a VRT from a list of datasets.
7
9 gdalbuildvrt [-tileindex field_name]
10 [-resolution {highest|lowest|average|user}]
11 [-te xmin ymin xmax ymax] [-tr xres yres] [-tap]
12 [-separate] [-b band]* [-sd subdataset]
13 [-allow_projection_difference] [-q]
14 [-optim {[AUTO]/VECTOR/RASTER}]
15 [-addalpha] [-hidenodata]
16 [-srcnodata "value [value...]"] [-vrtnodata "value [value...]"]
17 [-a_srs srs_def]
18 [-r {nearest,bilinear,cubic,cubicspline,lanczos,average,mode}]
19 [-oo NAME=VALUE]*
20 [-input_file_list my_list.txt] [-overwrite] output.vrt [gdalfile]*
21
23 This program builds a VRT (Virtual Dataset) that is a mosaic of the
24 list of input GDAL datasets. The list of input GDAL datasets can be
25 specified at the end of the command line, or put in a text file (one
26 filename per line) for very long lists, or it can be a MapServer
27 tileindex (see gdaltindex utility). In the later case, all entries in
28 the tile index will be added to the VRT.
29 With -separate, each files goes into a separate band in the VRT band.
31 Otherwise, the files are considered as tiles of a larger mosaic and the
32 VRT file has as many bands as one of the input files.
33 If one GDAL dataset is made of several subdatasets and has 0 raster
35 bands, all the subdatasets will be added to the VRT rather than the
36 dataset itself.
37 gdalbuildvrt does some amount of checks to assure that all files that
39 will be put in the resulting VRT have similar characteristics : number
40 of bands, projection, color interpretation... If not, files that do not
41 match the common characteristics will be skipped. (This is only true in
42 the default mode, and not when using the -separate option)
43 If there is some amount of spatial overlapping between files, the order
45 of files appearing in the list of source matter: files that are listed
46 at the end are the ones from which the content will be fetched. Note
47 that nodata will be taken into account to potentially fetch data from
48 less prioritary datasets, but currently, alpha channel is not taken
49 into account to do alpha compositing (so a source with alpha=0
50 appearing on top of another source will override is content). This
51 might be changed in later versions.
52 This utility is somehow equivalent to the gdal_vrtmerge.py utility and
54 is build by default in GDAL 1.6.1.
55 -tileindex:
57 Use the specified value as the tile index field, instead of the
58 default value with is 'location'.
59 -resolution {highest|lowest|average|user}:
61 In case the resolution of all input files is not the same, the
62 -resolution flag enables the user to control the way the output
63 resolution is computed. 'average' is the default. 'highest' will
64 pick the smallest values of pixel dimensions within the set of
65 source rasters. 'lowest' will pick the largest values of pixel
66 dimensions within the set of source rasters. 'average' will compute
67 an average of pixel dimensions within the set of source rasters.
68 'user' is new in GDAL 1.7.0 and must be used in combination with
69 the -tr option to specify the target resolution.
70 -tr xres yres :
72 (starting with GDAL 1.7.0) set target resolution. The values must
73 be expressed in georeferenced units. Both must be positive values.
74 Specifying those values is of course incompatible with
75 highest|lowest|average values for -resolution option.
76 -tap:
78 (GDAL >= 1.8.0) (target aligned pixels) align the coordinates of
79 the extent of the output file to the values of the -tr, such that
80 the aligned extent includes the minimum extent.
81 -te xmin ymin xmax ymax :
83 (starting with GDAL 1.7.0) set georeferenced extents of VRT file.
84 The values must be expressed in georeferenced units. If not
85 specified, the extent of the VRT is the minimum bounding box of the
86 set of source rasters.
87 -addalpha:
89 (starting with GDAL 1.7.0) Adds an alpha mask band to the VRT when
90 the source raster have none. Mainly useful for RGB sources (or
91 grey-level sources). The alpha band is filled on-the-fly with the
92 value 0 in areas without any source raster, and with value 255 in
93 areas with source raster. The effect is that a RGBA viewer will
94 render the areas without source rasters as transparent and areas
95 with source rasters as opaque. This option is not compatible with
96 -separate.
97 -hidenodata:
99 (starting with GDAL 1.7.0) Even if any band contains nodata value,
100 giving this option makes the VRT band not report the NoData. Useful
101 when you want to control the background color of the dataset. By
102 using along with the -addalpha option, you can prepare a dataset
103 which doesn't report nodata value but is transparent in areas with
104 no data.
105 -srcnodata value [value...]:
107 (starting with GDAL 1.7.0) Set nodata values for input bands
108 (different values can be supplied for each band). If more than one
109 value is supplied all values should be quoted to keep them together
110 as a single operating system argument. If the option is not
111 specified, the intrinsic nodata settings on the source datasets
112 will be used (if they exist). The value set by this option is
113 written in the NODATA element of each ComplexSource element. Use a
114 value of None to ignore intrinsic nodata settings on the source
115 datasets.
116 -b band:
118 (GDAL >= 1.10.0) Select an input band to be processed. Bands are
119 numbered from 1. If input bands not set all bands will be added to
120 vrt. Multiple -b switches may be used to select a set of input
121 bands.
122 -sd subdataset
124 (GDAL >= 1.10.0) If the input dataset contains several subdatasets
125 use a subdataset with the specified number (starting from 1). This
126 is an alternative of giving the full subdataset name as an input.
127 -vrtnodata value [value...]:
129 (starting with GDAL 1.7.0) Set nodata values at the VRT band level
130 (different values can be supplied for each band). If more than one
131 value is supplied all values should be quoted to keep them together
132 as a single operating system argument. If the option is not
133 specified, intrinsic nodata settings on the first dataset will be
134 used (if they exist). The value set by this option is written in
135 the NoDataValue element of each VRTRasterBand element. Use a value
136 of None to ignore intrinsic nodata settings on the source datasets.
137 -separate:
139 (starting with GDAL 1.7.0) Place each input file into a separate
140 band. In that case, only the first band of each dataset will be
141 placed into a new band. Contrary to the default mode, it is not
142 required that all bands have the same datatype.
143 -allow_projection_difference:
145 (starting with GDAL 1.7.0) When this option is specified, the
146 utility will accept to make a VRT even if the input datasets have
147 not the same projection. Note: this does not mean that they will be
148 reprojected. Their projection will just be ignored.
149 -optim {[AUTO]/VECTOR/RASTER}}:
151 (starting with GDAL 2.3) Force the algorithm used (results are
152 identical). The raster mode is used in most cases and optimise
153 read/write operations. The vector mode is useful with a decent
154 amount of input features and optimise the CPU use. That mode have
155 to be used with tiled images to be efficient. The auto mode (the
156 default) will chose the algorithm based on input and output
157 properties.
158 -a_srs srs_def:
160 (starting with GDAL 1.10) Override the projection for the output
161 file. The srs_def may be any of the usual GDAL/OGR forms, complete
162 WKT, PROJ.4, EPSG:n or a file containing the WKT. No reprojection
163 is done.
164 -r {nearest (default),bilinear,cubic,cubicspline,lanczos,average,mode}:
166 (GDAL >= 2.0) Select a resampling algorithm.
167 -oo NAME=VALUE:
169 (starting with GDAL 2.2) Dataset open option (format specific)
170 -input_file_list:
172 To specify a text file with an input filename on each line
173 -q:
175 (starting with GDAL 1.7.0) To disable the progress bar on the
176 console
177 -overwrite:
179 Overwrite the VRT if it already exists.
180
182 Make a virtual mosaic from all TIFF files contained in a directory :
183 gdalbuildvrt doq_index.vrt doq/*.tif
185 Make a virtual mosaic from files whose name is specified in a text file
188 :
189 gdalbuildvrt -input_file_list my_list.txt doq_index.vrt
191 Make a RGB virtual mosaic from 3 single-band input files :
194 gdalbuildvrt -separate rgb.vrt red.tif green.tif blue.tif
196 Make a virtual mosaic with blue background colour (RGB: 0 0 255) :
199 gdalbuildvrt -hidenodata -vrtnodata "0 0 255" doq_index.vrt doq/*.tif
201
204 Even Rouault even.rouault@mines-paris.org
205GDAL Tue Mar 3 2020 gdalbuildvrt(1)