Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
r.buildvrt(1)		    GRASS GIS User's Manual		 r.buildvrt(1)

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

KEYWORDS
       raster, mosaic, virtual raster

SYNOPSIS
       r.buildvrt
       r.buildvrt --help
       r.buildvrt  [input=name[,name,...]]    [file=name]   output=name	  [ti-
       tle=phrase]   [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

   Flags:
       --overwrite
	   Allow output	files to overwrite existing files

       --help
	   Print usage summary

       --verbose
	   Verbose module output

       --quiet
	   Quiet module	output

       --ui
	   Force launching GUI dialog

   Parameters:
       input=name[,name,...]
	   Name	of input raster	files

       file=name
	   Input file with one raster map name per line

       output=nameA [required]
	   Name	for output raster map

       title=phrase
	   Title for resultant raster map

DESCRIPTION
       r.buildvrt  builds  a virtual raster (VRT) that is a mosaic of the list
       of input	raster maps. The purpose of such a VRT is to provide fast  ac-
       cess  to	small subsets of the VRT, also with multiple simultaneous read
       requests.

NOTES
       r.buildvrt creates a list of raster maps	that can be located in differ-
       ent mapsets. The	output is a read-only link to the original raster maps
       which is	only valid if the original raster maps remain  in  the	origi-
       nally indicated mapset. A VRT can also be built from raster maps	regis-
       tered with r.external.

       Reading the whole VRT is	slower	than  reading  the  equivalent	single
       raster  map. Only reading small parts of	the VRT	provides a performance
       benefit.

       A GRASS virtual raster can be  regarded	as  a  simplified  version  of
       GDAL's  virtual raster format.  The GRASS equivalent is simpler because
       issues like nodata, projection, resolution, resampling, masking are al-
       ready handled by	native GRASS raster routines.

EXAMPLES
   VRT from a DEM in the North Carolina	sample dataset
       # set the region
       g.region	raster=elev_state_500m -p
       # higher	resolution
       g.region	res=50 -p
       # resample the DEM to 50	meter
       r.resamp.interp input=elev_state_500m output=elev_state_50m method=bilinear
       # create	tiles
       r.tile input=elev_state_50m output=elev_state_50m_tile_ width=1000 height=1000 overlap=0
       # dump list of tiles to a file
       g.list type=raster pattern=elev_state_50m_tile_*	output=tilelist
       # build a vrt
       r.buildvrt file=tilelist	output=elev_state_50m_vrt

SEE ALSO
	r.tile,	r.patch, r.external

       The equivalent GDAL utility gdalbuildvrt

AUTHOR
       Markus Metz
       Sponsored by mundialis

SOURCE CODE
       Available at: r.buildvrt	source code (history)

       Main  index  | Raster index | Topics index | Keywords index | Graphical
       index | Full index

       A(C) 2003-2020 GRASS Development	Team, GRASS GIS	7.8.4 Reference	Manual

GRASS 7.8.4							 r.buildvrt(1)

NAME | KEYWORDS | SYNOPSIS | DESCRIPTION | NOTES | EXAMPLES | SEE ALSO | AUTHOR | SOURCE CODE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=r.buildvrt&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help