GriddedSurface (FPScript)
Interpolates a two-dimensional data set using Natural Neighbor interpolation and samples this at definable points.
Syntax
GriddedSurface(Surface, NX, NZ, SamplingMode)
or
GriddedSurface(DataMatrix, LocusX, LocusZ, NX, NZ, SamplingMode)
The syntax of the GriddedSurface function consists of the following parts:
Part |
Description |
||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Surface |
The data matrix or signal series with a Z component with a constant sampling interval, which is interpolated. If the X and Z components are missing, they will be generated automatically. Permitted data structures are data matrix und signal series. All numeric data types are permitted. For complex data types the absolute value is formed. If the argument is a list, then the function is executed for each element of the list and the result is also a list. |
||||||||||
DataMatrix |
Data matrix with the Y component of the signal series to be interpolated. If you specify a signal series, then its Y component is used. Permitted data structures are data matrix und signal series. All numeric data types are permitted. For complex data types the absolute value is formed. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. |
||||||||||
LocusX |
Data series with the X component of the signal series to be interpolated. If you specify a signal, then its Y component is used. Permitted data structures are data series und signal. All numeric data types are permitted. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. |
||||||||||
LocusZ |
Data series with the Z component of the signal series to be interpolated. If you specify a signal, then its Y component is used. Permitted data structures are data series und signal. All numeric data types are permitted. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. |
||||||||||
NX |
Specifies the total number of points or per X interval of the signal series. Permitted data structures are scalar value. All integral data types are permitted. The value must be greater or equal to 0. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. |
||||||||||
NZ |
Specifies the total number of points or per Z interval of the signal series. Permitted data structures are scalar value. All integral data types are permitted. The value must be greater or equal to 0. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. |
||||||||||
SamplingMode |
Specifies how the calculated spline surface is to be sampled. The argument SamplingMode can have the following values:
...plus forms a constant, which determines how the edges of the surface are handled.
If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. |
Remarks
The result always has the data type 64-bit floating point.
The result has the same unit as the argument Surface.
The Y component of the data set to be interpolated must contain at least 3 x 3 values.
The X and Z component of the data set cannot contain void values. Void values in the Y component are handled as missing sampling points.
The following illustrations show a Natural Neighbor surface and the data it is based on:
Available in
FlexPro Basic, Professional, Developer Suite
Examples
GriddedSurface({{0, 0, 0, 0}, {0, 1, 0, 0}, {0, 0, -1, 0}, {0, 0, 0, 0}}, 100, 100, SPLINE_EQUIDISTANT) |
Interpolates the data matrix through "natural neighbor" interpolation. |
See Also
Surface Interpolation Analysis Object
2D Approximation Analysis Object
References
[1] "Watson, Dave": "nngridr - An Implementation of Natural Neighbor Interpolation". "Dave Watson Publisher, Claremont, Australia",1994.
[2] "Watson, Dave": "Contouring: - A Guide To The Analysis and Display of Spatial Data". "Pergamon Press",1992.ISBN 0-08-040286-0.