SAGA-GIS Tool Library Documentation (v9.2.0)

Tool Inverse Distance Weighted (3D)

Inverse distance weighted interpolation for 3-dimensional data points. Output will be a grid collection with evenly spaced Z-levels representing the 3rd dimension.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputPointsshapes, inputPOINTS--
Target System (*)grid, input, optional, CMDTARGET_TEMPLATEuse this grid's system for output grids-
OutputGrid Collectiongrid collection, outputGRIDS--
OptionsZtable fieldZ_FIELD--
Z Factorfloating point numberZ_SCALE-Default: 1.000000
Valuetable fieldV_FIELD--
Target Grid SystemchoiceTARGET_DEFINITION-Available Choices:
[0] user defined
[1] grid or grid system
Default: 0
Cellsizefloating point numberTARGET_USER_SIZE-Minimum: 0.000000
Default: 1.000000
Westfloating point numberTARGET_USER_XMIN-Default: 0.000000
Eastfloating point numberTARGET_USER_XMAX-Default: 100.000000
Southfloating point numberTARGET_USER_YMIN-Default: 0.000000
Northfloating point numberTARGET_USER_YMAX-Default: 100.000000
Columnsinteger numberTARGET_USER_COLSNumber of cells in East-West direction.Minimum: 1
Default: 101
Rowsinteger numberTARGET_USER_ROWSNumber of cells in North-South direction.Minimum: 1
Default: 101
FitchoiceTARGET_USER_FITS-Available Choices:
[0] nodes
[1] cells
Default: 0
Grid Systemgrid systemTARGET_SYSTEM--
Cellsizefloating point numberTARGET_USER_ZSIZE-Minimum: 0.000000
Default: 1.000000
Bottomfloating point numberTARGET_USER_ZMIN-Default: 0.000000
Topfloating point numberTARGET_USER_ZMAX-Default: 100.000000
Levelsinteger numberTARGET_USER_ZNUM-Minimum: 1
Default: 101
Search RangechoiceSEARCH_RANGE-Available Choices:
[0] local
[1] global
Default: 1
Maximum Search Distancefloating point numberSEARCH_RADIUSlocal maximum search distance given in map unitsMinimum: 0.000000
Default: 1000.000000
Number of PointschoiceSEARCH_POINTS_ALL-Available Choices:
[0] maximum number of nearest points
[1] all points within search distance
Default: 1
Minimuminteger numberSEARCH_POINTS_MINminimum number of points to useMinimum: 1
Default: 1
Maximuminteger numberSEARCH_POINTS_MAXmaximum number of nearest pointsMinimum: 1
Default: 20
Weighting FunctionchoiceDW_WEIGHTING-Available Choices:
[0] no distance weighting
[1] inverse distance to a power
[2] exponential
[3] gaussian
Default: 0
Powerfloating point numberDW_IDW_POWER-Minimum: 0.000000
Default: 2.000000
Bandwidthfloating point numberDW_BANDWIDTHBandwidth for exponential and Gaussian weightingMinimum: 0.000000
Default: 1.000000
(*) optional

Command-line

Usage: saga_cmd grids_tools 6 [-POINTS <str>] [-Z_FIELD <str>] [-Z_SCALE <double>] [-V_FIELD <str>] [-TARGET_DEFINITION <str>] [-TARGET_USER_SIZE <double>] [-TARGET_USER_XMIN <double>] [-TARGET_USER_XMAX <double>] [-TARGET_USER_YMIN <double>] [-TARGET_USER_YMAX <double>] [-TARGET_USER_COLS <num>] [-TARGET_USER_ROWS <num>] [-TARGET_USER_FITS <str>] [-TARGET_TEMPLATE <str>] [-GRIDS <str>] [-TARGET_USER_ZSIZE <double>] [-TARGET_USER_ZMIN <double>] [-TARGET_USER_ZMAX <double>] [-TARGET_USER_ZNUM <num>] [-SEARCH_RANGE <str>] [-SEARCH_RADIUS <double>] [-SEARCH_POINTS_ALL <str>] [-SEARCH_POINTS_MIN <num>] [-SEARCH_POINTS_MAX <num>] [-DW_WEIGHTING <str>] [-DW_IDW_POWER <double>] [-DW_BANDWIDTH <double>]
  -POINTS:<str>              	Points
	shapes, input
  -Z_FIELD:<str>             	Z
	table field
  -Z_SCALE:<double>          	Z Factor
	floating point number
	Default: 1.000000
  -V_FIELD:<str>             	Value
	table field
  -TARGET_DEFINITION:<str>   	Target Grid System
	choice
	Available Choices:
	[0] user defined
	[1] grid or grid system
	Default: 0
  -TARGET_USER_SIZE:<double> 	Cellsize
	floating point number
	Minimum: 0.000000
	Default: 1.000000
  -TARGET_USER_XMIN:<double> 	West
	floating point number
	Default: 0.000000
  -TARGET_USER_XMAX:<double> 	East
	floating point number
	Default: 100.000000
  -TARGET_USER_YMIN:<double> 	South
	floating point number
	Default: 0.000000
  -TARGET_USER_YMAX:<double> 	North
	floating point number
	Default: 100.000000
  -TARGET_USER_COLS:<num>    	Columns
	integer number
	Minimum: 1
	Default: 101
  -TARGET_USER_ROWS:<num>    	Rows
	integer number
	Minimum: 1
	Default: 101
  -TARGET_USER_FITS:<str>    	Fit
	choice
	Available Choices:
	[0] nodes
	[1] cells
	Default: 0
  -TARGET_TEMPLATE:<str>     	Target System
	grid, input, optional, CMD
  -GRIDS:<str>               	Grid Collection
	grid collection, output
  -TARGET_USER_ZSIZE:<double>	Cellsize
	floating point number
	Minimum: 0.000000
	Default: 1.000000
  -TARGET_USER_ZMIN:<double> 	Bottom
	floating point number
	Default: 0.000000
  -TARGET_USER_ZMAX:<double> 	Top
	floating point number
	Default: 100.000000
  -TARGET_USER_ZNUM:<num>    	Levels
	integer number
	Minimum: 1
	Default: 101
  -SEARCH_RANGE:<str>        	Search Range
	choice
	Available Choices:
	[0] local
	[1] global
	Default: 1
  -SEARCH_RADIUS:<double>    	Maximum Search Distance
	floating point number
	Minimum: 0.000000
	Default: 1000.000000
  -SEARCH_POINTS_ALL:<str>   	Number of Points
	choice
	Available Choices:
	[0] maximum number of nearest points
	[1] all points within search distance
	Default: 1
  -SEARCH_POINTS_MIN:<num>   	Minimum
	integer number
	Minimum: 1
	Default: 1
  -SEARCH_POINTS_MAX:<num>   	Maximum
	integer number
	Minimum: 1
	Default: 20
  -DW_WEIGHTING:<str>        	Weighting Function
	choice
	Available Choices:
	[0] no distance weighting
	[1] inverse distance to a power
	[2] exponential
	[3] gaussian
	Default: 0
  -DW_IDW_POWER:<double>     	Power
	floating point number
	Minimum: 0.000000
	Default: 2.000000
  -DW_BANDWIDTH:<double>     	Bandwidth
	floating point number
	Minimum: 0.000000
	Default: 1.000000