SAGA-GIS Tool Library Documentation (v9.2.0)

Tool Import from Virtual Raster (VRT)

The tool allows one to clip / extract a raster subset from a virtual raster dataset (VRT). Such a VRT is actually an XML based description of a mosaic of raster datasets and can be created with the "Create Virtual Raster (VRT)" tool.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputShapes Extentshapes, inputSHAPESThe shapefile defining the clipping extent.-
OutputGridsgrid list, outputGRIDS--
OptionsVRT Filenamefile pathVRT_NAMEThe full path and name of the .vrt file.-
ExtentchoiceEXTENTChoose how to define the clipping extent.Available Choices:
[0] user defined
[1] grid system
[2] shapes extent
Default: 0
Grid Systemgrid systemGRIDSYSTEMThe target grid system.-
Leftfloating point numberXMINThe minimum x-coordinate of the clipping extent.Default: 0.000000
Rightfloating point numberXMAXThe maximum x-coordinate of the clipping extent.Default: 0.000000
Bottomfloating point numberYMINThe minimum y-coordinate of the clipping extent.Default: 0.000000
Topfloating point numberYMAXThe maximum y-coordinate of the clipping extent.Default: 0.000000
Bufferfloating point numberBUFFERThe optional buffer added to the clipping extent [map units].Minimum: 0.000000
Default: 0.000000
Multiple Bands OutputchoiceMULTIPLEChoose how to handle output datasets with multiple bands.Available Choices:
[0] single grids
[1] grid collection
[2] automatic
Default: 2
TransformationbooleanTRANSFORMAlign grid to coordinate system.Default: 1
ResamplingchoiceRESAMPLINGResampling type to be used, if grid needs to be aligned to coordinate system.Available Choices:
[0] Nearest Neighbour
[1] Bilinear Interpolation
[2] Bicubic Spline Interpolation
[3] B-Spline Interpolation
Default: 0

Command-line

Usage: saga_cmd io_gdal 13 [-VRT_NAME <str>] [-GRIDS <str>] [-EXTENT <str>] [-GRIDSYSTEM_D <double>] [-GRIDSYSTEM_X <double>] [-GRIDSYSTEM_Y <double>] [-GRIDSYSTEM_NX <num>] [-GRIDSYSTEM_NY <num>] [-GRIDSYSTEM_FILE <str>] [-SHAPES <str>] [-XMIN <double>] [-XMAX <double>] [-YMIN <double>] [-YMAX <double>] [-BUFFER <double>] [-MULTIPLE <str>] [-TRANSFORM <str>] [-RESAMPLING <str>]
  -VRT_NAME:<str>       	VRT Filename
	file path
  -GRIDS:<str>          	Grids
	grid list, output
  -EXTENT:<str>         	Extent
	choice
	Available Choices:
	[0] user defined
	[1] grid system
	[2] shapes extent
	Default: 0
  -GRIDSYSTEM_D:<double>	Cell Size
  -GRIDSYSTEM_X:<double>	Lower Left Center Cell X-Coordinate
  -GRIDSYSTEM_Y:<double>	Lower Left Center Cell Y-Coordinate
  -GRIDSYSTEM_NX:<num>  	Number of Columns
  -GRIDSYSTEM_NY:<num>  	Number of Rows
  -GRIDSYSTEM_FILE:<str>	Grid File
  -SHAPES:<str>         	Shapes Extent
	shapes, input
  -XMIN:<double>        	Left
	floating point number
	Default: 0.000000
  -XMAX:<double>        	Right
	floating point number
	Default: 0.000000
  -YMIN:<double>        	Bottom
	floating point number
	Default: 0.000000
  -YMAX:<double>        	Top
	floating point number
	Default: 0.000000
  -BUFFER:<double>      	Buffer
	floating point number
	Minimum: 0.000000
	Default: 0.000000
  -MULTIPLE:<str>       	Multiple Bands Output
	choice
	Available Choices:
	[0] single grids
	[1] grid collection
	[2] automatic
	Default: 2
  -TRANSFORM:<str>      	Transformation
	boolean
	Default: 1
  -RESAMPLING:<str>     	Resampling
	choice
	Available Choices:
	[0] Nearest Neighbour
	[1] Bilinear Interpolation
	[2] Bicubic Spline Interpolation
	[3] B-Spline Interpolation
	Default: 0