SAGA 9.3.3 | Tool Library Documentation

Import Grid from XYZ


Description

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
OutputGriddata object Grid, output, optionalGRIDThe imported grid.-
Count Griddata object Grid, output, optionalCOUNTThe number of values detected in each grid cell.-
OptionsFilefile pathFILENAMEThe input file.-
Skip Leading Linesinteger numberSKIPThe 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 Typedata typeTYPE-Available Choices: [0] bit [1] unsigned 1 byte integer [2] signed 1 byte integer [3] unsigned 2 byte integer [4] signed 2 byte integer [5] unsigned 4 byte integer [6] signed 4 byte integer [7] unsigned 8 byte integer [8] signed 8 byte integer [9] 4 byte floating point number [10] 8 byte floating point number Default: 9
Cell Sizefloating point numberCELLSIZEThe 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

Command Line


Usage: saga_cmd io_grid 6 [-GRID ] [-COUNT ] [-FILENAME ] [-SKIP ] [-SEPARATOR ] [-USER ] [-TYPE ] [-CELLSIZE ] [-COUNT_CREATE ]
  -GRID:        	Grid
	data object Grid, output, optional
  -COUNT:       	Count Grid
	data object Grid, output, optional
  -FILENAME:    	File
	file path
  -SKIP:        	Skip Leading Lines
	integer number
	Minimum: 0
	Default: 0
  -SEPARATOR:   	Separator
	choice
	Available Choices:
	[0] default delimiters
	[1] space
	[2] ,
	[3] ;
	[4] tabulator
	[5] user defined
	Default: 0
  -USER:        	User Defined
	text
	Default: *
  -TYPE:        	Data Storage Type
	data type
	Available Choices:
	[0] bit
	[1] unsigned 1 byte integer
	[2] signed 1 byte integer
	[3] unsigned 2 byte integer
	[4] signed 2 byte integer
	[5] unsigned 4 byte integer
	[6] signed 4 byte integer
	[7] unsigned 8 byte integer
	[8] signed 8 byte integer
	[9] 4 byte floating point number
	[10] 8 byte floating point number
	Default: 9
  -CELLSIZE: 	Cell Size
	floating point number
	Minimum: 0.000000
	Default: 1.000000
  -COUNT_CREATE:	Count Grid
	boolean
	Default: 0