SAGA 9.3.3 | Tool Library Documentation

Multilevel B-Spline


Description

Multilevel B-spline algorithm for spatial interpolation of scattered data as proposed by Lee, Wolberg and Shin (1997). The algorithm makes use of a coarse-to-fine hierarchy of control lattices to generate a sequence of bicubic B-spline functions, whose sum approaches the desired interpolation function. Performance gains are realized by using B-spline refinement to reduce the sum of these functions into one equivalent B-spline function. The 'Maximum Level' determines the maximum size of the final B-spline matrix and increases exponential with each level. Where level=10 requires about 1mb level=12 needs about 16mb and level=14 about 256mb(!) of additional memory.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputPointsshapes, inputSHAPES--
Target Systemgrid, input, optional, CMDTARGET_TEMPLATEuse this grid's system for output grids-
OutputTarget Gridgrid, outputTARGET_OUT_GRID--
OptionsAttributetable fieldFIELD--
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--
RefinementchoiceMETHOD-Available Choices: [0] no [1] yes Default: 0
Threshold Errorfloating point numberEPSILON-Minimum: 0.000000 Default: 0.000100
Maximum Levelinteger numberLEVEL_MAX-Minimum: 1 Maximum: 14 Default: 11
Update Viewboolean, GUIUPDATE-Default: 0

Command Line


Usage: saga_cmd grid_spline 4 [-SHAPES ] [-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_FITS ] [-TARGET_TEMPLATE ] [-TARGET_OUT_GRID ] [-METHOD ] [-EPSILON ] [-LEVEL_MAX ]
  -SHAPES:             	Points
	shapes, input
  -FIELD:              	Attribute
	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_FITS:   	Fit
	choice
	Available Choices:
	[0] nodes
	[1] cells
	Default: 0
  -TARGET_TEMPLATE:    	Target System
	grid, input, optional, CMD
  -TARGET_OUT_GRID:    	Target Grid
	grid, output
  -METHOD:             	Refinement
	choice
	Available Choices:
	[0] no
	[1] yes
	Default: 0
  -EPSILON:         	Threshold Error
	floating point number
	Minimum: 0.000000
	Default: 0.000100
  -LEVEL_MAX:          	Maximum Level
	integer number
	Minimum: 1
	Maximum: 14
	Default: 11