Tool 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.

Author: O.Conrad (c) 2006
Menu: Grid|Gridding|Spline Interpolation

Parameters

	Name	Type	Identifier	Description	Constraints
Input	Points	Shapes (input)	`SHAPES`	-	-
Input	Target System (*)	Grid (optional input)	`TARGET_TEMPLATE`	use this grid's system for output grids	-
Output	Target Grid	Grid (output)	`TARGET_OUT_GRID`	-	-
Options	Attribute	Table field	`FIELD`	-	-
	Target Grid System	Choice	`TARGET_DEFINITION`	-	Available Choices: [0] user defined [1] grid or grid system Default: 0
	Cellsize	Floating point	`TARGET_USER_SIZE`	-	Minimum: 0.000000 Default: 1.000000
	West	Floating point	`TARGET_USER_XMIN`	-	Default: 0.000000
	East	Floating point	`TARGET_USER_XMAX`	-	Default: 100.000000
	South	Floating point	`TARGET_USER_YMIN`	-	Default: 0.000000
	North	Floating point	`TARGET_USER_YMAX`	-	Default: 100.000000
	Columns	Integer	`TARGET_USER_COLS`	Number of cells in East-West direction.	Minimum: 1 Default: 100
	Rows	Integer	`TARGET_USER_ROWS`	Number of cells in North-South direction.	Minimum: 1 Default: 100
	Fit	Choice	`TARGET_USER_FITS`	-	Available Choices: [0] nodes [1] cells Default: 0
	Grid System	Grid system	`TARGET_SYSTEM`	-	-
	Regularisation	Floating point	`REGULARISATION`	-	Minimum: 0.000000 Default: 0.000100
	Search Range	Choice	`SEARCH_RANGE`	-	Available Choices: [0] local [1] global Default: 1
	Maximum Search Distance	Floating point	`SEARCH_RADIUS`	local maximum search distance given in map units	Minimum: 0.000000 Default: 1000.000000
	Number of Points	Choice	`SEARCH_POINTS_ALL`	-	Available Choices: [0] maximum number of nearest points [1] all points within search distance Default: 1
	Minimum	Integer	`SEARCH_POINTS_MIN`	minimum number of points to use	Minimum: 1 Default: 16
	Maximum	Integer	`SEARCH_POINTS_MAX`	maximum number of nearest points	Minimum: 1 Default: 20
	Direction	Choice	`SEARCH_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_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>] [-TARGET_OUT_GRID <str>] [-REGULARISATION <double>] [-SEARCH_RANGE <str>] [-SEARCH_RADIUS <double>] [-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_SIZE:<double>	Cellsize
	Floating point
	Minimum: 0.000000
	Default: 1.000000
  -TARGET_USER_XMIN:<double>	West
	Floating point
	Default: 0.000000
  -TARGET_USER_XMAX:<double>	East
	Floating point
	Default: 100.000000
  -TARGET_USER_YMIN:<double>	South
	Floating point
	Default: 0.000000
  -TARGET_USER_YMAX:<double>	North
	Floating point
	Default: 100.000000
  -TARGET_USER_COLS:<num>   	Columns
	Integer
	Minimum: 1
	Default: 100
  -TARGET_USER_ROWS:<num>   	Rows
	Integer
	Minimum: 1
	Default: 100
  -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:<double>  	Regularisation
	Floating point
	Minimum: 0.000000
	Default: 0.000100
  -SEARCH_RANGE:<str>       	Search Range
	Choice
	Available Choices:
	[0] local
	[1] global
	Default: 1
  -SEARCH_RADIUS:<double>   	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: 1
  -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