SAGA-GIS Tool Library Documentation (v8.2.1)

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 pointXMINThe minimum x-coordinate of the clipping extent.Default: 0.000000
RightFloating pointXMAXThe maximum x-coordinate of the clipping extent.Default: 0.000000
BottomFloating pointYMINThe minimum y-coordinate of the clipping extent.Default: 0.000000
TopFloating pointYMAXThe maximum y-coordinate of the clipping extent.Default: 0.000000
BufferFloating pointBUFFERThe 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
	Default: 0.000000
  -XMAX:<double>        	Right
	Floating point
	Default: 0.000000
  -YMIN:<double>        	Bottom
	Floating point
	Default: 0.000000
  -YMAX:<double>        	Top
	Floating point
	Default: 0.000000
  -BUFFER:<double>      	Buffer
	Floating point
	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