SAGA-GIS Module Library Documentation (v2.2.2)

Module Thin Plate Spline

Creates a 'Thin Plate Spline' function for each grid point based on all of the scattered data points that are within a given distance. The number of points can be limited to a maximum number of closest points.

References:
- Donato G., Belongie S. (2002): 'Approximation Methods for Thin Plate Spline Mappings and Principal Warps', In Heyden, A., Sparr, G., Nielsen, M., Johansen, P. (Eds.): 'Computer Vision - ECCV 2002: 7th European Conference on Computer Vision, Copenhagen, Denmark, May 28-31, 2002', Proceedings, Part III, Lecture Notes in Computer Science. Springer-Verlag Heidelberg; pp.21-31.

- Elonen, J. (2005): 'Thin Plate Spline editor - an example program in C++', http://elonen.iki.fi/code/tpsdemo/index.html.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputPointsShapes (input)SHAPES--
Target System (*)Grid (optional input)TARGET_TEMPLATEuse this grid's system for output grids-
OutputTarget GridGrid (output)TARGET_OUT_GRID--
OptionsAttributeTable fieldFIELD--
Target Grid SystemChoiceTARGET_DEFINITION-Available Choices:
[0] user defined
[1] grid or grid system
Default: 0
LeftFloating pointTARGET_USER_XMIN-Default: 0.000000
RightFloating pointTARGET_USER_XMAX-Default: 100.000000
BottomFloating pointTARGET_USER_YMIN-Default: 0.000000
TopFloating pointTARGET_USER_YMAX-Default: 100.000000
CellsizeFloating pointTARGET_USER_SIZE-Minimum: 0.000000
Default: 1.000000
FitChoiceTARGET_USER_FITS-Available Choices:
[0] nodes
[1] cells
Default: 0
RegularisationFloating pointREGULARISATION-Minimum: 0.000000
Default: 0.000100
Search RangeChoiceSEARCH_RANGE-Available Choices:
[0] local
[1] global
Default: 0
Maximum Search DistanceFloating pointSEARCH_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: 0
MinimumIntegerSEARCH_POINTS_MINminimum number of points to useMinimum: 1
Default: 16
MaximumIntegerSEARCH_POINTS_MAXmaximum number of nearest pointsMinimum: 1
Default: 20
DirectionChoiceSEARCH_DIRECTION-Available Choices:
[0] all directions
[1] quadrants
Default: 0
(*) optional

Command-line

Usage: saga_cmd grid_spline 1 [-SHAPES <str>] [-FIELD <str>] [-TARGET_DEFINITION <str>] [-TARGET_USER_XMIN <str>] [-TARGET_USER_XMAX <str>] [-TARGET_USER_YMIN <str>] [-TARGET_USER_YMAX <str>] [-TARGET_USER_SIZE <str>] [-TARGET_USER_FITS <str>] [-TARGET_TEMPLATE <str>] [-TARGET_OUT_GRID <str>] [-REGULARISATION <str>] [-SEARCH_RANGE <str>] [-SEARCH_RADIUS <str>] [-SEARCH_POINTS_ALL <str>] [-SEARCH_POINTS_MIN <num>] [-SEARCH_POINTS_MAX <num>] [-SEARCH_DIRECTION <str>]
  -SHAPES:<str>           	Points
	Shapes (input)
  -FIELD:<str>            	Attribute
	Table field
  -TARGET_DEFINITION:<str>	Target Grid System
	Choice
	Available Choices:
	[0] user defined
	[1] grid or grid system
	Default: 0
  -TARGET_USER_XMIN:<str> 	Left
	Floating point
	Default: 0.000000
  -TARGET_USER_XMAX:<str> 	Right
	Floating point
	Default: 100.000000
  -TARGET_USER_YMIN:<str> 	Bottom
	Floating point
	Default: 0.000000
  -TARGET_USER_YMAX:<str> 	Top
	Floating point
	Default: 100.000000
  -TARGET_USER_SIZE:<str> 	Cellsize
	Floating point
	Minimum: 0.000000
	Default: 1.000000
  -TARGET_USER_FITS:<str> 	Fit
	Choice
	Available Choices:
	[0] nodes
	[1] cells
	Default: 0
  -TARGET_TEMPLATE:<str>  	Target System
	Grid (optional input)
  -TARGET_OUT_GRID:<str>  	Target Grid
	Grid (output)
  -REGULARISATION:<str>   	Regularisation
	Floating point
	Minimum: 0.000000
	Default: 0.000100
  -SEARCH_RANGE:<str>     	Search Range
	Choice
	Available Choices:
	[0] local
	[1] global
	Default: 0
  -SEARCH_RADIUS:<str>    	Maximum Search Distance
	Floating point
	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: 0
  -SEARCH_POINTS_MIN:<num>	Minimum
	Integer
	Minimum: 1
	Default: 16
  -SEARCH_POINTS_MAX:<num>	Maximum
	Integer
	Minimum: 1
	Default: 20
  -SEARCH_DIRECTION:<str> 	Direction
	Choice
	Available Choices:
	[0] all directions
	[1] quadrants
	Default: 0