1r.buildvrt(1) Grass User's Manual r.buildvrt(1)
2
3
4
6 r.buildvrt - Build a VRT (Virtual Raster) from the list of input
7 raster maps.
8
10 raster, mosaic, virtual raster
11
13 r.buildvrt
14 r.buildvrt --help
15 r.buildvrt [input=name[,name,...]] [file=name] output=name
16 [title=phrase] [--overwrite] [--help] [--verbose] [--quiet]
17 [--ui]
18
19 Flags:
20 --overwrite
21 Allow output files to overwrite existing files
22
23 --help
24 Print usage summary
25
26 --verbose
27 Verbose module output
28
29 --quiet
30 Quiet module output
31
32 --ui
33 Force launching GUI dialog
34
35 Parameters:
36 input=name[,name,...]
37 Name of input raster files
38
39 file=name
40 Input file with one raster map name per line
41
42 output=name [required]
43 Name for output raster map
44
45 title=phrase
46 Title for resultant raster map
47
49 r.buildvrt builds a virtual raster (VRT) that is a mosaic of the list
50 of input raster maps. The purpose of such a VRT is to provide fast
51 access to small subsets of the VRT, also with multiple simultaneous
52 read requests.
53
55 r.buildvrt creates a list of raster maps that can be located in differ‐
56 ent mapsets. The output is a read-only link to the original raster maps
57 which is only valid if the original raster maps remain in the origi‐
58 nally indicated mapset. A VRT can also be built from raster maps regis‐
59 tered with r.external.
60
61 Reading the whole VRT is slower than reading the equivalent single
62 raster map. Only reading small parts of the VRT provides a performance
63 benefit.
64
65 A GRASS virtual raster can be regarded as a simplified version of
66 GDAL’s virtual raster format. The GRASS equivalent is simpler because
67 issues like nodata, projection, resolution, resampling, masking are
68 already handled by native GRASS raster routines.
69
71 VRT from a DEM in the North Carolina sample dataset
72 # set the region
73 g.region raster=elev_state_500m -p
74 # higher resolution
75 g.region res=50 -p
76 # resample the DEM to 50 meter
77 r.resamp.interp input=elev_state_500m output=elev_state_50m method=bilinear
78 # create tiles
79 r.tile input=elev_state_50m output=elev_state_50m_tile_ width=1000 height=1000 overlap=0
80 # dump list of tiles to a file
81 g.list type=raster pattern=elev_state_50m_tile_* > tilelist
82 # build a vrt
83 r.buildvrt file=tilelist output=elev_state_50m_vrt
84
86 r.tile, r.patch
87
88 The equivalent GDAL utility gdalbuildvrt
89
91 Markus Metz
92
93 Last changed: $Date: 2018-12-26 17:29:08 +0100 (Wed, 26 Dec 2018) $
94
96 Available at: r.buildvrt source code (history)
97
98 Main index | Raster index | Topics index | Keywords index | Graphical
99 index | Full index
100
101 © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
102
103
104
105GRASS 7.6.0 r.buildvrt(1)