SAGA-GIS Tool Library Documentation (v9.1.2)

Tool Export Grid to XYZ

The tool allows one to export a grid or several grids to a table (text format), which stores the x/y-coordinates and the cell values of the input grid(s).
By default, No-Data cells are not written to the output. This can be changed with the "Write No-Data" parameter. If No-Data cells are skipped, these are detected for the first input grid which operates like a mask.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputGridsGrid list, inputGRIDSThe grid(s) to export.-
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
FileFile pathFILENAMEThe output file.-
Write HeaderBooleanHEADERWrite a header to the .xyz file.Default: 1
Write No-DataBooleanNODATAWrite No-Data cells to the .xyz file.Default: 0
Floating Point PrecisionIntegerPRECNumber of decimals of exported floating point values. A value of -1 writes the significant decimals.Minimum: -1
Default: 2
Field SeparatorChoiceSEPARATOR-Available Choices:
[0] tabulator
[1] ;
[2] ,
[3] space
[4] other
Default: 0
otherTextSEP_OTHER-Default: *

Command-line

Usage: saga_cmd io_grid 5 [-GRIDS <str>] [-FILENAME <str>] [-HEADER <str>] [-NODATA <str>] [-PREC <num>] [-SEPARATOR <str>] [-SEP_OTHER <str>]
  -GRIDS:<str>    	Grids
	Grid list, input
  -FILENAME:<str> 	File
	File path
  -HEADER:<str>   	Write Header
	Boolean
	Default: 1
  -NODATA:<str>   	Write No-Data
	Boolean
	Default: 0
  -PREC:<num>     	Floating Point Precision
	Integer
	Minimum: -1
	Default: 2
  -SEPARATOR:<str>	Field Separator
	Choice
	Available Choices:
	[0] tabulator
	[1] ;
	[2] ,
	[3] space
	[4] other
	Default: 0
  -SEP_OTHER:<str>	other
	Text
	Default: *