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 | - | - |
| 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 |
| Left | Floating point | TARGET_USER_XMIN | - | Default: 0.000000 |
| Right | Floating point | TARGET_USER_XMAX | - | Default: 100.000000 |
| Bottom | Floating point | TARGET_USER_YMIN | - | Default: 0.000000 |
| Top | Floating point | TARGET_USER_YMAX | - | Default: 100.000000 |
| 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: 0 |
| 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: 0 |
| 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_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> Left
Floating point
Default: 0.000000
-TARGET_USER_XMAX:<double> Right
Floating point
Default: 100.000000
-TARGET_USER_YMIN:<double> Bottom
Floating point
Default: 0.000000
-TARGET_USER_YMAX:<double> Top
Floating point
Default: 100.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:<double> 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:<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: 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