Thin Plate Spline

Author(s)	O.Conrad (c) 2006
Library ID	grid_spline
Tool ID	1
Version	1.0
Menu	Grid \| Gridding \| Spline Interpolation

Description

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

	Name	Type	Identifier	Description	Constraints
Input	Points	shapes, input	`SHAPES`	-	-
Input	Target System	grid, input, optional	`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 number	`TARGET_USER_SIZE`	-	Minimum: 0.000000 Default: 1.000000
	West	floating point number	`TARGET_USER_XMIN`	-	Default: 0.000000
	East	floating point number	`TARGET_USER_XMAX`	-	Default: 100.000000
	South	floating point number	`TARGET_USER_YMIN`	-	Default: 0.000000
	North	floating point number	`TARGET_USER_YMAX`	-	Default: 100.000000
	Columns	integer number	`TARGET_USER_COLS`	Number of cells in East-West direction.	Minimum: 1 Default: 101
	Rows	integer number	`TARGET_USER_ROWS`	Number of cells in North-South direction.	Minimum: 1 Default: 101
	Rounding	boolean	`TARGET_USER_FLAT`	Round bounding coordinates to multiples of cell size. Ignored if cell size has decimal places.	Default: 1
	Fit	choice	`TARGET_USER_FITS`	-	Available Choices: [0] nodes [1] cells Default: 0
	Grid System	grid system	`TARGET_SYSTEM`	-	-
	Regularisation	floating point number	`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 number	`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 number	`SEARCH_POINTS_MIN`	minimum number of points to use	Minimum: 1 Default: 16
	Maximum	integer number	`SEARCH_POINTS_MAX`	maximum number of nearest points	Minimum: 1 Default: 20

Command Line


Usage: saga_cmd grid_spline 1 [-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_FLAT ] [-TARGET_USER_FITS ] [-TARGET_TEMPLATE ] [-TARGET_OUT_GRID ] [-REGULARISATION ] [-SEARCH_RANGE ] [-SEARCH_RADIUS ] [-SEARCH_POINTS_ALL ] [-SEARCH_POINTS_MIN ] [-SEARCH_POINTS_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_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
  -TARGET_OUT_GRID:       Target Grid
	grid, output
  -REGULARISATION:     Regularisation
	floating point number
	Minimum: 0.000000
	Default: 0.000100
  -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: 16
  -SEARCH_POINTS_MAX:     Maximum
	integer number
	Minimum: 1
	Default: 20