1r.buildvrt(1)                 Grass User's Manual                r.buildvrt(1)
2
3
4

NAME

6       r.buildvrt   -  Build  a  VRT  (Virtual  Raster) from the list of input
7       raster maps.
8

KEYWORDS

10       raster, mosaic, virtual raster
11

SYNOPSIS

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

DESCRIPTION

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

NOTES

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

EXAMPLES

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_* output=tilelist
82       # build a vrt
83       r.buildvrt file=tilelist output=elev_state_50m_vrt
84

SEE ALSO

86        r.tile, r.patch, r.external
87
88       The equivalent GDAL utility gdalbuildvrt
89

AUTHOR

91       Markus Metz
92       Sponsored by mundialis
93

SOURCE CODE

95       Available at: r.buildvrt source code (history)
96
97       Main index | Raster index | Topics index | Keywords index  |  Graphical
98       index | Full index
99
100       © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
101
102
103
104GRASS 7.8.2                                                      r.buildvrt(1)