SAGA-GIS Tool Library Documentation (v9.1.2)

Tool Import Grid from XYZ

The tool allows one to import gridded data from a table (text format), which contains for each grid cell the x/y-coordinates and the cell value. If several values end up in a single grid cell, the mean value of all input values is written to that cell.

Parameters

 NameTypeIdentifierDescriptionConstraints
OutputGrid (*)Data Object Grid, output, optionalGRIDThe imported grid.-
Count Grid (*)Data Object Grid, output, optionalCOUNTThe number of values detected in each grid cell.-
OptionsFileFile pathFILENAMEThe input file.-
Skip Leading LinesIntegerSKIPThe number of leading lines to skip (usually header data).Minimum: 0
Default: 0
SeparatorChoiceSEPARATOR-Available Choices:
[0] default delimiters
[1] space
[2] ,
[3] ;
[4] tabulator
[5] user defined
Default: 0
User DefinedTextUSERThe user defined delimiter.Default: *
Data Storage TypeChoiceTYPE-Available Choices:
[0] 1 bit
[1] 1 byte unsigned integer
[2] 1 byte signed integer
[3] 2 byte unsigned integer
[4] 2 byte signed integer
[5] 4 byte unsigned integer
[6] 4 byte signed integer
[7] 4 byte floating point
[8] 8 byte floating point
Default: 7
Cell SizeFloating pointCELLSIZEThe cell size of the output grid. Set to zero to let the tool suggest an appropriate cellsize.Minimum: 0.000000
Default: 1.000000
Count GridBooleanCOUNT_CREATECreate a grid with the number of values falling into each target grid cell.Default: 0
(*) optional

Command-line

Usage: saga_cmd io_grid 6 [-GRID <str>] [-COUNT <str>] [-FILENAME <str>] [-SKIP <num>] [-SEPARATOR <str>] [-USER <str>] [-TYPE <str>] [-CELLSIZE <double>] [-COUNT_CREATE <str>]
  -GRID:<str>        	Grid
	Data Object Grid, output, optional
  -COUNT:<str>       	Count Grid
	Data Object Grid, output, optional
  -FILENAME:<str>    	File
	File path
  -SKIP:<num>        	Skip Leading Lines
	Integer
	Minimum: 0
	Default: 0
  -SEPARATOR:<str>   	Separator
	Choice
	Available Choices:
	[0] default delimiters
	[1] space
	[2] ,
	[3] ;
	[4] tabulator
	[5] user defined
	Default: 0
  -USER:<str>        	User Defined
	Text
	Default: *
  -TYPE:<str>        	Data Storage Type
	Choice
	Available Choices:
	[0] 1 bit
	[1] 1 byte unsigned integer
	[2] 1 byte signed integer
	[3] 2 byte unsigned integer
	[4] 2 byte signed integer
	[5] 4 byte unsigned integer
	[6] 4 byte signed integer
	[7] 4 byte floating point
	[8] 8 byte floating point
	Default: 7
  -CELLSIZE:<double> 	Cell Size
	Floating point
	Minimum: 0.000000
	Default: 1.000000
  -COUNT_CREATE:<str>	Count Grid
	Boolean
	Default: 0