SAGA 9.6.1 | Tool Library Documentation

Inverse Distance Weighted (3D)


Description

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 Systemgrid, input, optionalTARGET_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
RoundingbooleanTARGET_USER_FLATRound bounding coordinates to multiples of cell size. Ignored if cell size has decimal places.Default: 1
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: 1
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

Command Line


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