Interpolation.interp3 Method (InArray<Single>, InArray<Single>, InArray<Single>, InArray<Single>, InArray<Single>, InArray<Single>, InArray<Single>, Int32, InterpolationMethod)

public static RetArray<float> interp3(
	InArray<float> V,
	InArray<float> X1 = null,
	InArray<float> X2 = null,
	InArray<float> X3 = null,
	InArray<float> Xn1 = null,
	InArray<float> Xn2 = null,
	InArray<float> Xn3 = null,
	int k = 0,
	InterpolationMethod method = InterpolationMethod.linear
)

Public Shared Function interp3 ( 
	V As InArray(Of Single),
	Optional X1 As InArray(Of Single) = Nothing,
	Optional X2 As InArray(Of Single) = Nothing,
	Optional X3 As InArray(Of Single) = Nothing,
	Optional Xn1 As InArray(Of Single) = Nothing,
	Optional Xn2 As InArray(Of Single) = Nothing,
	Optional Xn3 As InArray(Of Single) = Nothing,
	Optional k As Integer = 0,
	Optional method As InterpolationMethod = InterpolationMethod.linear
) As RetArray(Of Single)

Dim V As InArray(Of Single)
Dim X1 As InArray(Of Single)
Dim X2 As InArray(Of Single)
Dim X3 As InArray(Of Single)
Dim Xn1 As InArray(Of Single)
Dim Xn2 As InArray(Of Single)
Dim Xn3 As InArray(Of Single)
Dim k As Integer
Dim method As InterpolationMethod
Dim returnValue As RetArray(Of Single)

returnValue = Interpolation.interp3(V, X1, 
	X2, X3, Xn1, Xn2, Xn3, k, method)

Parameters

V

Type: ILNumerics.InArray<Single>
3 dimensional array with sample values.

X1 (Optional)

Type: ILNumerics.InArray<Single>
[Optional] Positions of grid points in V for dimension 1, specified as a matrix in meshgrid format or grid vector. Monotonically increasing.

X2 (Optional)

Type: ILNumerics.InArray<Single>
[Optional] Positions of grid points in V for dimension 2, specified as a matrix in meshgrid format or grid vector. Monotonically increasing.

X3 (Optional)

Type: ILNumerics.InArray<Single>
[Optional] Positions of grid points in V for dimension 3, specified as a matrix in meshgrid format or grid vector. Monotonically increasing.

Xn1 (Optional)

Type: ILNumerics.InArray<Single>
[Optional] Query point positions for dimension 1, specified as grid vector or matrix in meshgrid format. Monotonically increasing.

Xn2 (Optional)

Type: ILNumerics.InArray<Single>
[Optional] Query point positions for dimension 2, specified as grid vector or matrix in meshgrid format. Monotonically increasing.

Xn3 (Optional)

Type: ILNumerics.InArray<Single>
[Optional] Query point positions for dimension 3, specified as grid vector or matrix in meshgrid format. Monotonically increasing.

k (Optional)

Type: System.Int32
[Optional] Refinement factor for default query grid positions. Ranges specified by X1,X2 and/or X3 are split k times. Ignored for any of Xn1, Xn2 or Xn3 being not null.

method (Optional)

Type: ILNumerics.Toolboxes.InterpolationMethod
[Optional] Interpolation method. Default: linear.

Return Value

interp3(InArray<Single> , Nullable<Single> , InArray<Single> , InArray<Single> , InArray<Single> , InArray<Single> , InArray<Single> , InArray<Single> , Int32, InterpolationMethod) performs three dimensional interpolation over the given data array V. The parameter X1 specifies the positions of the grid points in V along the first dimension (the columns of V). X2 determines the positions along the 2nd dimension (rows of V) and so forth. Hence, V forms a regular, rectilinear grid of (non-)uniform spacing in three dimensions.

Values in X1, X2 and X3, if provided, must be strictly monotonically increasing but not necessarily be uniform. If any of X1, X2 and/or X3 are ommitted for dimension d, default grid positions are assumed with uniform range of spacing 1: 0:1:m, where m = size(V, d).

Values in Xn1, Xn2 and Xn3, if provided, must be strictly monotonically increasing but not necessarily have uniform spacing. If any of Xn1, Xn2 and/or Xn3 are ommitted, default query grid positions are assumed by subdividing X1, X2 and/or X3 respectively, 'k' times.

Interpolation methods: all methods from the enum InterpolationMethod are supported. See interp1(InArray<Single> , Nullable<Single> , InArray<Single> , InArray<Single> , Int32, InterpolationMethod) for a detailed description.

By default interp3(InArray<Single> , InArray<Single> , InArray<Single> , InArray<Single> , InArray<Single> , InArray<Single> , InArray<Single> , Int32, InterpolationMethod) assigns NaN to all query points laying outside of the range of X1, X2 and X3. Use the overload interp3(InArray<Single> , Nullable<Single> , InArray<Single> , InArray<Single> , InArray<Single> , InArray<Single> , InArray<Single> , InArray<Single> , Int32, InterpolationMethod) in order to specify another value for grid points laying out-of-range or to create extrapolated values for them by specifying the outOfRange parameter as null.

[ILNumerics Interpolation Toolbox]

Reference